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. Esos valores de esas propiedades se pueden usar para configurar el parámetro pageToken a fin de 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 consulta "perro patinador":
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 10 resultados siguientes:
La siguiente consulta recupera los 10 resultados siguientes para 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 API. Ejecuta la consulta que recupera los primeros 10 resultados para obtener el valor del parámetro pageToken correcto.