Implementação: canais

Nesta página, explicamos como usar a API YouTube Data (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 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:

Definir as informações de branding de um 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â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

    Seu aplicativo 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 o 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 do canal. Uma seção do canal é um conjunto de vídeos que são exibidos em um canal. Por exemplo, uma seção pode incluir os envios mais recentes, os envios 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 de parâmetro mine como true. Esse parâmetro indica que você está recuperando seções do canal do usuário autenticado no momento.

Fazer upload 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 defini-la para um canal. A imagem será 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, essa consulta não pode ser testada usando o APIs Explorer porque ele não oferece suporte à capacidade de fazer upload de arquivos de mídia, que é um requisito para esse método.