L'esempio seguente mostra come recuperare insiemi di risultati aggiuntivi per le query dell'API YouTube Data (v3).
L'API utilizza il parametro maxResults per indicare il numero di elementi da includere in una risposta dell'API. Quasi tutti i metodi list dell'API (videos.list, playlists.list e così via) supportano questo parametro.
Se sono disponibili risultati aggiuntivi per una query, la risposta dell'API conterrà una proprietà nextPageToken, una proprietà prevPageToken o entrambe. I valori di queste proprietà possono essere utilizzati per impostare il parametro pageToken in modo da recuperare un'altra pagina di risultati.
Ad esempio, la seguente query recupera i risultati di ricerca per i 10 video più visti corrispondenti alla query "cane skateboard":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
La risposta dell'API contiene le prime 10 corrispondenze per la query, nonché una proprietà nextPageToken che può essere utilizzata per recuperare i 10 risultati successivi:
La query riportata di seguito recupera i 10 risultati successivi per la query:
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:per completare questa richiesta in Explorer API, potrebbe essere necessario aggiornare il valore del parametro pageToken. Esegui la query che recupera i primi 10 risultati per ottenere il valore corretto del parametro pageToken.