Esta página mostra exemplos de solicitações para a API YouTube Data. Você usa a API de dados do YouTube para recuperar e manipular recursos do YouTube, como vídeos, canais e playlists. Cada exemplo é vinculado a e preenche o Google APIs Explorer para que você possa executar o exemplo e ver a resposta.
Para mais informações sobre o envio de conteúdo pela API YouTube Data, consulte Envios retomáveis.
Visão geral
Para fins de clareza da apresentação, os exemplos nesta página mostram os elementos distintos de cada solicitação e abreviam o URL de base do host que processa as solicitações da API Data (https://www.googleapis.com/youtube/v3). Para fazer a solicitação fora do contexto das amostras, inclua o URL completo.
Por exemplo, aqui está um exemplo de solicitação como aparece nesta página:
GET {base-URL}/channels?part=contentDetails &mine=true
O URL completo da solicitação é:
GET https://www.googleapis.com/youtube/v3/channels?part=contentDetails &mine=true
Várias das solicitações recuperam dados que só podem ser acessados pelo proprietário do canal do YouTube, como a lista de inscritos. Essas solicitações exigem que o proprietário do canal conceda ao APIs Explorer do Google o direito de realizar solicitações da API YouTube Data em nome dele. Consulte Como implementar a autenticação OAuth 2.0 para detalhes sobre como autorizar o acesso a dados de canais privados. Após vincular à ferramenta APIs Explorer, clique no botão Autorizar solicitações usando o OAuth 2.0. Esta etapa autoriza o APIs Explorer a fazer solicitações em nome do proprietário. Você também seleciona o escopo da autorização, que especifica os tipos de solicitações que o APIs Explorer pode realizar.
A resposta a cada solicitação é a representação JSON de um recurso do YouTube. O parâmetro part na solicitação especifica quais partes do recurso são incluídas na resposta. O parâmetro identifica uma ou mais propriedades de recurso de nível superior (não aninhadas) que devem ser incluídas na resposta. Por exemplo, algumas das partes de um recurso de vídeo são:
- snippet
- contentDetails
- jogador
- estatísticas
- status
Todas essas partes são objetos que contêm propriedades agrupadas, e esses objetos são considerados grupos de campos de metadados que podem (ou não) ser recuperados pelo servidor da API. Dessa forma, o parâmetro part requer que você selecione os componentes de recursos que seu aplicativo realmente usa.Consulte Introdução à API YouTube Data para mais informações.
Recuperar informações do canal
Essa solicitação usa o método channels.list para recuperar detalhes sobre os canais que pertencem ao usuário autenticado.
GET {base_URL}/channels?part=contentDetails &mine=true
A resposta a essa solicitação inclui o ID do canal e contentDetails para o canal do usuário autenticado. O contentDetails inclui as várias playlists geradas pelo sistema associadas ao canal. Muitas das solicitações seguintes exigem o ID do canal ou um dos IDs das playlists, por isso é importante registrá-los.
{
"id": {CHANNEL_ID},
"kind": "youtube#channel",
"etag": etag,
"contentDetails": {
"relatedPlaylists": {
"likes": {LIKES_PLAYLIST_ID},
"favorites": {FAVORITES_PLAYLIST_ID},
"uploads": {UPLOADS_PLAYLIST_ID},
"watchHistory": {WATCHHISTORY_PLAYLIST_ID},
"watchLater":