O exemplo a seguir mostra como recuperar conjuntos adicionais de resultados de consultas da API YouTube Data (v3).
A API usa o parâmetro maxResults
para indicar quantos itens precisam ser incluídos em uma resposta. Quase todos os métodos list
da API (videos.list
, playlists.list
etc.) oferecem suporte a esse parâmetro.
Se mais resultados estiverem disponíveis para uma consulta, a resposta da API conterá uma propriedade nextPageToken
, uma prevPageToken
ou ambas. Os valores dessas propriedades podem ser usados para definir o parâmetro pageToken
e recuperar uma página adicional de resultados.
Por exemplo, a consulta a seguir recupera os resultados da pesquisa dos 10 vídeos mais visualizados que correspondem à consulta "cachorro de skate":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
A resposta da API contém as 10 primeiras correspondências para a consulta, bem como uma propriedade nextPageToken
que pode ser usada para recuperar os próximos 10 resultados.
A consulta abaixo recupera os próximos 10 resultados.
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
Observação: talvez seja necessário atualizar o valor do parâmetro pageToken
para concluir essa solicitação no APIs Explorer. Execute a consulta que recupera os primeiros 10 resultados para encontrar o valor correto do parâmetro pageToken
.