Os exemplos a seguir demonstram como concluir vários tipos diferentes de solicitações de pesquisa na API v3.
Vídeos
Este exemplo chama o método search.list
para encontrar os vídeos em alta definição (HD) mais visualizados associados à consulta "skateboarding dog". A consulta define os parâmetros order
, part
, q
, type
e videoDefinition
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Consulte a documentação do método search.list
para conferir exemplos de código.
Playlists
Este exemplo mostra como encontrar playlists que correspondem ao termo de consulta "GoogleDevelopers". Ele chama o método search.list
e define o valor do parâmetro type
como playlist
para que o conjunto de resultados inclua apenas playlists.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Canais
Este exemplo mostra como encontrar canais que correspondem ao termo de consulta "travel". Ele chama o método search.list
e define o valor do parâmetro type
como channel
para que o conjunto de resultados inclua apenas canais.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Resultados relevantes para um idioma específico
Este exemplo chama o método search.list
para encontrar os resultados de pesquisa mais relevantes para um idioma específico. O exemplo mostra que o termo da consulta é marine (q=marine
) e que a resposta da API precisa conter os resultados mais relevantes para o idioma francês (relevanceLanguage=fr
).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
A solicitação não define um valor para o parâmetro type
, o que significa que cada resultado da pesquisa pode fazer referência a um vídeo, playlist ou canal.
Vídeos enviados pelo app ou site do desenvolvedor
Este exemplo mostra como usar o parâmetro forDeveloper
para restringir uma pesquisa a apenas vídeos enviados pelo aplicativo ou site do desenvolvedor. Esse parâmetro pode ser usado com parâmetros de pesquisa opcionais, como q
.
Observação:essa consulta não retorna resultados no APIs Explorer porque ele não oferece suporte a uploads de vídeo. É possível executar essa consulta para seu próprio aplicativo fora do APIs Explorer, mas não é possível receber resultados para seu aplicativo usando o APIs Explorer.
Cada vídeo enviado é marcado automaticamente com o número de projeto associado ao aplicativo do desenvolvedor no console da API Google.
Quando uma solicitação de pesquisa define o parâmetro forDeveloper
como verdadeiro, o serviço da API usa as credenciais de autorização da solicitação para identificar o desenvolvedor. Assim, um desenvolvedor pode restringir os resultados a vídeos enviados pelo próprio app ou site, mas não a vídeos enviados por outros apps ou sites.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true