Youtube Data APIで取得する動画範囲を指定したい

Question

現在、YoutubeDataAPIを使用して、簡易的なyoutube動画検索サイトを作成しています。
もしよろしければ、ご回答お願いします。

問題点

クエリパラメータmaxResults=10で、取得できる動画の数を決定しました。
しかし、ページネーションを実装するにあたって、「次へ」ボタンなどを押したときに、ヒットしたものの中で11~20番目の動画を取得する方法がわかりませんでした。

解決したいこと

上記の例では、最初の検索で10個の動画を取得し、「次へ」ボタンを押したときに11~20番目にヒットした動画を取得したい。

##やったこと
maxResults=100のように一度に多くの動画を取得し、それを10個ずつページに表示するという形はできました。

しかし、根本解決になっていないので質問させていただきました。

Answer 1

APIのレスポンス中の nextPageToken の値を、「pageToken」パラメータに設定すればよいのではないでしょうか？

たとえば、最初に取得して返ってきたJSONが

{
  "kind": "youtube#searchListResponse",
  "etag": "xxxx",
  "nextPageToken": "CAoQAA",
  "regionCode": "JP",
  "pageInfo": {
    "totalResults": 364,
    "resultsPerPage": 10
  },
  "items": [
    {
    }
  ]
}

であれば、nextPageToken が「CAoQAA」なので、

https://www.googleapis.com/youtube/v3/search?part=snippet,id&channelId=UCxxxxxxxxxxxx&key=xxxxxxx&maxResults=10&pageToken=CAoQAA

でAPIを叩くと、次の10件が返ってくると思います。

Comments

[samepanda]

ご回答ありがとうございます。
nextPageToken(prevPageToken)パラメータによって、前後の10件が取得できるのですね。
確かに公式ページを確認したところ、同様の記述があり、見落としてました。
ベストアンサーにさせていただきます。
ありがとうございました。