Implementação: canais

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:

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â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 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 como brandingSettings.

    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
    

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.