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 quanti elementi devono essere inclusi in una risposta 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 che recuperi una pagina di risultati aggiuntiva.
Ad esempio, la seguente query recupera i risultati di ricerca relativi ai 10 video più visti che corrispondono alla query "skateboard dog":
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 e una proprietà nextPageToken che può essere utilizzata per recuperare i 10 risultati successivi:
La query seguente 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 del parametro pageToken corretto.