Implementação: solicitações de pesquisa

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 associados à consulta "cachorro de skate". 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 ver 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 "viagem". 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 resultados da pesquisa mais relevantes para um idioma específico. O exemplo mostra que o termo de 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 referenciar um vídeo, uma playlist ou um canal.

Vídeos enviados pelo app ou site do desenvolvedor

Este exemplo mostra como usar o parâmetro forDeveloper para restringir uma pesquisa para recuperar apenas vídeos enviados pelo app ou site do desenvolvedor. Esse parâmetro pode ser usado com parâmetros de pesquisa opcionais, como o parâmetro q.

Observação:essa consulta não retorna resultados no APIs Explorer porque o API Explorer não é compatível com uploads de vídeo. É possível executar essa consulta no seu próprio aplicativo fora do APIs Explorer, mas não é possível ver resultados para seu aplicativo usando o APIs Explorer.

Cada vídeo enviado é marcado automaticamente com o número do projeto associado ao aplicativo do desenvolvedor no Console de APIs do 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