実装: ページ分け

次の例は、YouTube Data API（v3）クエリの追加の結果セットを取得する方法を示しています。

API は、maxResults パラメータを使用して、API レスポンスに含めるアイテムの数を示します。API のほぼすべての list メソッド（videos.list、playlists.list など）は、このパラメータをサポートしています。

クエリに対して追加の結果を使用できる場合、API レスポンスには nextPageToken プロパティと prevPageToken プロパティのいずれかまたは両方が含まれます。これらのプロパティ値を使用して、pageToken パラメータを設定して結果の追加ページを取得できます。

たとえば、次のクエリは、「skateboarding dog」というクエリに一致する上位 10 件の動画の検索結果を取得します。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

API レスポンスには、クエリの最初の 10 個の一致と、次の 10 個の結果を取得するために使用できる nextPageToken プロパティが含まれています。

次のクエリは、このクエリの次の 10 件の結果を取得します。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

注: API エクスプローラでこのリクエストを完了するには、pageToken パラメータの値の更新が必要になる場合があります。最初の 10 件の結果を取得するクエリを実行して、正しい pageToken パラメータ値を取得します。