En el siguiente ejemplo, se muestra cómo recuperar conjuntos adicionales de resultados para las consultas de la API de datos de YouTube (v3).
La API usa el parámetro maxResults para indicar cuántos elementos se deben incluir en una respuesta de la API. Casi todos los métodos list de la API (videos.list, playlists.list, etc.) admiten ese parámetro.
Si hay resultados adicionales disponibles para una consulta, la respuesta de la API contendrá una propiedad nextPageToken, una propiedad prevPageToken o ambas. Los valores de esas propiedades se pueden usar para establecer el parámetro pageToken y recuperar una página adicional de resultados.
Por ejemplo, la siguiente consulta recupera los resultados de la búsqueda de los 10 videos más vistos que coinciden con la búsqueda "perro en patineta":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
La respuesta de la API contiene las primeras 10 coincidencias de la consulta, así como una propiedad nextPageToken que se puede usar para recuperar los siguientes 10 resultados:
La siguiente consulta recupera los siguientes 10 resultados de la consulta:
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
Nota: Es posible que debas actualizar el valor del parámetro pageToken para completar esta solicitud en el Explorador de APIs. Ejecuta la consulta que recupera los primeros 10 resultados para obtener el valor correcto del parámetro pageToken.