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 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