Nesta página, explicamos como usar a API de dados do YouTube (v3) para executar funções relacionadas à recuperação e atualização de dados de canais. Um recurso de channel
inclui IDs de playlist que identificam vídeos enviados e marcados com "Gostei" de um canal. Para buscar essas informações ao chamar o método channels.list
, verifique se o valor do parâmetro part
inclui a parte do recurso contentDetails
.
Recuperar informações sobre um canal
Chame o método channels.list
para recuperar informações sobre um canal específico. Há algumas maneiras de identificar o canal:
-
Defina o valor do parâmetro
mine
comotrue
para recuperar informações do canal do YouTube do usuário autenticado no momento. Sua solicitação precisa ser autorizada usando o OAuth 2.0.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails,brandingSettings &mine=true
-
Defina o parâmetro
forUsername
com um nome de usuário do YouTube para recuperar informações do canal associado a ele. Este exemplo define o valor do parâmetroforUsername
comoGoogle
para recuperar informações do canal oficial do Google no YouTube.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &forUsername=Google
-
Defina o parâmetro
id
como o ID do canal do YouTube que identifica de maneira exclusiva o canal do qual você está recuperando informações. Este exemplo define o parâmetroid
comoUCK8sQmJBp8GCxrOtXWBpyEA
, que também identifica o canal oficial do Google no YouTube.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
Definir as informações de marca do canal
Este exemplo atualiza as opções de branding de um canal. O exemplo tem duas etapas:
-
Etapa 1: recuperar as opções de branding do canal
Chame o método
channels.list
e defina o valor do parâmetropart
comobrandingSettings
e o valor do parâmetromine
comotrue
.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=brandingSettings &mine=true
O aplicativo pode exibir as configurações recuperadas, permitindo que o usuário modifique as configurações para serem atualizadas.
-
Etapa 2: atualizar as opções da marca do canal
Chame o método
channels.list
e defina os seguintes valores:- Defina a propriedade
id
como o ID exclusivo do canal do YouTube. O ID pode ser extraído da resposta da API na etapa 1. - Defina o valor do parâmetro
part
comobrandingSettings
.
O link para o API Explorer abaixo cria um recurso
channel
com as seguintes configurações de marca:{ "id": "CHANNEL_ID", "brandingSettings": { "channel": { "description": "A great channel to be enjoyed by all.", "moderateComments": true, "showRelatedChannels": true, "showBrowseView": true, "featuredChannelsTitle": "Featured Channel Stuff", "featuredChannelsUrls": [ "UC_x5XG1OV2P6uZZ5FSM9Ttw", "UCBR8-60-B28hp2BmDPdntcQ", "UCK8sQmJBp8GCxrOtXWBpyEA" ], "profileColor": "#006600" } } }
Para concluir a solicitação no APIs Explorer, você precisa definir o valor da propriedade
id
como o ID do canal do usuário autenticado. Além disso, defina as propriedades da imagem de acordo com suas configurações atuais.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update? part=brandingSettings
- Defina a propriedade
Gerenciar seções do canal
A API é compatível com os métodos channelSections.list, channelSections.insert, channelSections.update e channelSections.delete para gerenciar seções de canais. Uma seção do canal é um conjunto de vídeos em destaque em um canal. Por exemplo, uma seção pode incluir os envios mais recentes, os vídeos mais acessados ou vídeos de uma ou mais playlists.
O exemplo abaixo recupera as seções do canal oficial do Google no YouTube. A solicitação chama o método channelSections.list
e define o valor do parâmetro channelId
como UCK8sQmJBp8GCxrOtXWBpyEA
, que é o ID do canal do Google.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list? part=snippet,contentDetails &channelId=UCK8sQmJBp8GCxrOtXWBpyEA
Essa solicitação requer autorização se, em vez de usar o parâmetro channelId
, você definir o valor do parâmetro mine
como true
. Esse parâmetro indica que você está recuperando seções de canais para o canal do usuário autenticado no momento.
Enviar e definir uma imagem de marca-d'água para um canal
Você pode chamar o método watermarks.set
para fazer upload de uma imagem de marca-d'água e configurá-la para um canal. A imagem é exibida durante a reprodução dos vídeos do canal especificado. Você também pode especificar um canal de destino ao qual a imagem será vinculada, bem como detalhes de tempo que determinam quando a marca d'água aparece e por quanto tempo ela fica visível.
O método watermarks.unset
exclui a imagem de marca d'água de um canal.
Infelizmente, não é possível testar essa consulta usando o APIs Explorer porque o APIs Explorer não é compatível com o recurso de upload de arquivos de mídia, o que é um requisito desse método.