Implementação: canais

Nesta página, explicamos como usar a API Data do YouTube (v3) para realizar funções relacionadas à recuperação e atualização de dados do canal. Um recurso channel inclui IDs de playlist que identificam os vídeos enviados e marcados como "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:

Definir as informações de branding de um canal

Neste exemplo, as opções de branding de um canal são atualizadas. 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âmetro part como brandingSettings e o valor do parâmetro mine como true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    O app pode mostrar as configurações recuperadas, permitindo que o usuário as modifique para atualizar.

  • Etapa 2: atualizar as opções de branding 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 como brandingSettings.

    O link para a API Explorer abaixo cria um recurso channel com as seguintes configurações de branding:

    {
  "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, defina o valor da propriedade id como o ID do canal do usuário autenticado. Você também precisa definir as propriedades da imagem para corresponder às configurações atuais.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Gerenciar seções do canal

A API oferece suporte aos métodos channelSections.list, channelSections.insert, channelSections.update e channelSections.delete para gerenciar seções de canal. Uma seção do canal é um conjunto de vídeos que aparecem em um canal. Por exemplo, uma seção pode incluir os envios mais recentes de um canal, os mais populares ou vídeos de uma ou mais playlists.

O exemplo abaixo recupera as seções do canal oficial do YouTube do Google. 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 exige 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 do canal do usuário autenticado.

Fazer upload e definir uma imagem de marca-d'água para um canal

É possível chamar o método watermarks.set para fazer upload de uma imagem de marca d'água e definir para um canal. A imagem é mostrada 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, além de 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, essa consulta não pode ser testada usando o APIs Explorer porque ele não oferece suporte para fazer upload de arquivos de mídia, o que é um requisito para esse método.