Channels

A API agora permite marcar seu canal ou vídeos como "conteúdo para crianças". Além disso, channel e os recursos video agora também contêm uma propriedade que identifica o conteúdo para crianças o status do canal ou vídeo. Os Termos de Serviço e as políticas para desenvolvedores dos serviços de API do YouTube também foram atualizados em 10 de janeiro de 2020. Para obter mais informações, consulte os históricos de revisão de o Serviço da API YouTube Data e o Termos de Serviço dos Serviços de API do YouTube.

Um recurso channel contém informações sobre um canal do YouTube.

Métodos

A API é compatível com os seguintes métodos para recursos channels:

list
Retorna um conjunto de zero ou mais recursos channel que correspondem aos critérios da solicitação. Faça um teste agora.
update
Atualiza os metadados do canal. No momento, esse método só oferece suporte a atualizações dos objetos brandingSettings e invideoPromotion do recurso channel e das propriedades filhas. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso channels:

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo de recurso da API. O valor será youtube#channel.
etag etag
A Etag deste recurso.
id string
O ID que o YouTube usa para identificar o canal de forma exclusiva.
snippet object
O objeto snippet contém detalhes básicos sobre o canal, como título, descrição e imagens em miniatura.
snippet.title string
O título do canal.
snippet.description string
A descrição do canal. O valor da propriedade deve ter no máximo 1.000 caracteres.
snippet.customUrl string
O URL personalizado do canal. A Central de Ajuda do YouTube explica os requisitos de qualificação para receber um URL personalizado e como configurá-lo.
snippet.publishedAt datetime
A data e a hora em que o canal foi criado. O valor é especificado no formato ISO 8601.
snippet.thumbnails object
Um mapa de imagens em miniatura associadas ao canal. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.

Ao exibir miniaturas no aplicativo, confira se o código usa os URLs das imagens exatamente como são retornados nas respostas da API. Por exemplo, seu aplicativo não deve usar o domínio http em vez do domínio https em um URL retornado em uma resposta da API.

Os URLs de miniatura do canal estão disponíveis apenas no domínio https, que é como os URLs aparecem nas respostas da API. Você pode ver imagens corrompidas em seu aplicativo se ele tentar carregar imagens do YouTube a partir do domínio http. As imagens das miniaturas podem estar vazias em canais recém-criados e podem levar até um dia para serem preenchidas.
snippet.thumbnails.(key) object
Os valores-chave válidos são:
  • default: a imagem de miniatura padrão. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
  • medium – Uma versão de resolução mais alta da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura.
  • high – Uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
snippet.thumbnails.(key).url string
O URL da imagem. Consulte a definição da propriedade snippet.thumbnails para mais diretrizes sobre o uso de URLs de miniatura no seu aplicativo.
snippet.thumbnails.(key).width unsigned integer
A largura da imagem.
snippet.thumbnails.(key).height unsigned integer
A altura da imagem.
snippet.defaultLanguage string
O idioma do texto nas propriedades snippet.title e snippet.description do recurso channel.
snippet.localized object
O objeto snippet.localized contém um título e uma descrição localizados para o canal ou contém o título e a descrição do canal no idioma padrão para os metadados do canal.
  • O texto localizado será retornado no snippet do recurso se a solicitação channels.list tiver usado o parâmetro hl para especificar um idioma para o qual o texto localizado precisa ser retornado, o valor de parâmetro hl identificar um idioma do aplicativo YouTube e o texto localizado estiver disponível nesse idioma.
  • Os metadados do idioma padrão serão retornados se um valor de parâmetro hl não for especificado ou um valor for especificado, mas os metadados localizados não estiverem disponíveis para o idioma especificado.
A propriedade contém um valor somente leitura. Use o objeto localizations para adicionar, atualizar ou excluir metadados localizados.
snippet.localized.title string
O título localizado do canal.
snippet.localized.description string
A descrição localizada do canal.
snippet.country string
O país ao qual o canal está associado. Para definir o valor desta propriedade, atualize o valor da propriedade brandingSettings.channel.country.
contentDetails object
O objeto contentDetails encapsula informações sobre o conteúdo do canal.
contentDetails.relatedPlaylists object
O objeto relatedPlaylists é um mapa que identifica playlists associadas ao canal, como os vídeos enviados ou os vídeos marcados com "Gostei". Você pode recuperar qualquer uma dessas playlists usando o método playlists.list.
contentDetails.relatedPlaylists.likes string
O ID da playlist que contém os vídeos marcados com "Gostei" do canal. Use os métodos playlistItems.insert e playlistItems.delete para adicionar ou remover itens dessa lista.
contentDetails.relatedPlaylists.favorites string
Esta propriedade foi descontinuada.

O ID da playlist que contém os vídeos favoritos do canal. Use os métodos playlistItems.insert e playlistItems.delete para adicionar ou remover itens dessa lista.

O YouTube descontinuou a funcionalidade de vídeos favoritos. Por exemplo, a propriedade statistics.favoriteCount do recurso video foi suspensa em 28 de agosto de 2015. Como resultado, por motivos históricos, esse valor de propriedade pode conter um ID de playlist que se refere a uma playlist vazia e, portanto, não pode ser buscado.
contentDetails.relatedPlaylists.uploads string
O ID da playlist que contém os vídeos enviados do canal. Use o método videos.insert para enviar novos vídeos e o método videos.delete para excluir vídeos enviados anteriormente.
statistics object
O objeto statistics encapsula as estatísticas para o canal.
statistics.viewCount unsigned long
O número de visualizações do canal.
statistics.commentCount unsigned long
Esta propriedade foi descontinuada.

O número de comentários do canal.
statistics.subscriberCount unsigned long
O número de inscritos que o canal tem. Esse valor é arredondado para três algarismos significativos. Consulte a Histórico de revisões ou a Central de Ajuda do YouTube para mais informações detalhes sobre como as contagens de inscritos são arredondadas.
statistics.hiddenSubscriberCount boolean
Indica se a contagem de inscritos do canal é visível publicamente.
statistics.videoCount unsigned long
O número de vídeos públicos enviados para o canal. O valor reflete a contagem apenas os vídeos públicos do canal, mesmo para os proprietários. Esse comportamento é consistente com as contagens mostrados no site do YouTube.
topicDetails object
O objeto topicDetails encapsula informações sobre temas associados ao canal.

Importante:consulte a definição da propriedade topicDetails.topicIds[] e o histórico de revisões para mais detalhes sobre as mudanças relacionadas aos IDs de tópicos.
topicDetails.topicIds[] list
Uma lista de IDs de temas associados ao canal.

Essa propriedade foi descontinuada em 10 de novembro de 2016. Ele terá suporte até 10 de novembro de 2017.

Importante:devido à descontinuação do Freebase e da API Freebase, os IDs de tópicos começaram a funcionar de forma diferente desde 27 de fevereiro de 2017. Naquela época, o YouTube começou a retornar um pequeno conjunto de IDs de temas selecionados.

topicDetails.topicCategories[] list
Uma lista de URLs da Wikipédia que descrevem o conteúdo do canal.
status object
O objeto status encapsula informações sobre o status de privacidade do canal.
status.privacyStatus string
Status de privacidade do canal.

Os valores válidos para essa propriedade são:
  • private
  • public
  • unlisted
status.isLinked boolean
Indica se os dados do canal identificam um usuário que já está vinculado a um nome de usuário do YouTube ou a uma conta do Google+. Um usuário que tenha um desses links já tem uma identidade pública do YouTube, que é um pré-requisito para várias ações, como enviar vídeos.
status.longUploadsStatus string
Indica se o canal está qualificado para enviar vídeos com mais de 15 minutos de duração. Essa propriedade só será retornada se o proprietário do canal tiver autorizado a solicitação de API. Consulte a Central de Ajuda do YouTube para mais informações sobre esse recurso.

Os valores válidos para essa propriedade são:
  • allowed – Este canal pode enviar vídeos com mais de 15 minutos de duração.
  • disallowed – Este canal não pode ou não está qualificado para enviar vídeos com mais de 15 minutos de duração. Um canal só pode enviar vídeos longos se estiver em situação regular com base nas Diretrizes da comunidade do YouTube e não tiver bloqueios mundiais do Content ID no conteúdo.

    Depois que o proprietário do canal resolver os problemas que estão impedindo o envio de vídeos mais longos, o canal será revertido para o estado allowed ou eligible.
  • eligible – Este canal está qualificado para enviar vídeos com mais de 15 minutos de duração. No entanto, o proprietário do canal precisa ativar o recurso de envio de vídeos mais longos em https://www.youtube.com/verify. Acesse a Central de Ajuda do YouTube para mais informações sobre esse recurso.
status.madeForKids boolean
Este valor indica se o canal foi designado como feito para crianças e contém o conteúdo atual para crianças status do canal. Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids. Consulte a Central de Ajuda do YouTube para mais informações informações sobre como definir o público de seu canal, vídeos ou transmissões.
status.selfDeclaredMadeForKids boolean
Em uma solicitação channels.update, permite que o proprietário do canal classifique o canal como feito para crianças. O O valor da propriedade só será retornado se o proprietário do canal tiver autorizado a solicitação de API.
brandingSettings object
O objeto brandingSettings encapsula informações sobre a marca do canal.
brandingSettings.channel object
O objeto channel encapsula as propriedades de marca da página do canal.
brandingSettings.channel.title string
O título do canal. O título deve ter no máximo 30 caracteres.
brandingSettings.channel.description string
A descrição do canal, que aparece na caixa de informações na página do canal. O valor da propriedade deve ter no máximo 1.000 caracteres.
brandingSettings.channel.keywords string
Palavras-chave associadas ao seu canal. O valor é uma lista de strings separada por espaços. Canal palavras-chave poderão ser truncadas se ultrapassarem o tamanho máximo permitido de 500 caracteres ou se continham aspas sem escape ("). O limite de 500 caracteres não é um limite por palavra-chave, mas um limite no comprimento total de todas as palavras-chave.
brandingSettings.channel.trackingAnalyticsAccountId string
O ID de uma conta do Google Analytics que você quer usar para rastrear e medir o tráfego do seu canal.
brandingSettings.channel.unsubscribedTrailer string
O vídeo que deve ser reproduzido no módulo de vídeo em destaque na visualização de navegação da página do canal para espectadores não inscritos. Os espectadores inscritos podem ver outro vídeo que destaca a atividade mais recente do canal.

Se especificado, o valor da propriedade precisa ser o ID do vídeo do YouTube de um vídeo público ou não listado que pertença ao proprietário do canal.
brandingSettings.channel.defaultLanguage string
O idioma do texto nas propriedades snippet.title e snippet.description do recurso channel.
brandingSettings.channel.country string
O país ao qual o canal está associado. Atualize essa propriedade para definir o valor de snippet.country.
brandingSettings.watch object
Observação:esse objeto e todas as propriedades filhas dele foram descontinuadas.

O objeto watch encapsula as propriedades de marca das páginas de exibição para os vídeos do canal.
brandingSettings.watch.textColor string
Observação:essa propriedade foi descontinuada.

A cor do texto da área com marca da página de exibição do vídeo.
brandingSettings.watch.backgroundColor string
Observação:essa propriedade foi descontinuada.

A cor do plano de fundo da área com marca da página de exibição do vídeo.
brandingSettings.watch.featuredPlaylistId string
Observação:essa propriedade foi descontinuada. Se você tentar definir o valor, a API retornará um erro.
brandingSettings.image object
Essa propriedade e todas as propriedades filhas dela foram descontinuadas.

O objeto image encapsula informações sobre imagens que são exibidas na página do canal ou nas páginas de exibição de vídeos.
brandingSettings.image.bannerImageUrl string
Esta propriedade foi descontinuada.

O URL da imagem do banner mostrada na página do canal no site do YouTube. A imagem tem 1060 px por 175 px.
brandingSettings.image.bannerMobileImageUrl string
Essa propriedade foi descontinuada.

O URL da imagem do banner mostrada na página do canal em aplicativos para celular. A imagem tem 640 px por 175 px.
brandingSettings.image.watchIconImageUrl string
Essa propriedade foi descontinuada.

É o URL da imagem que aparece acima do player de vídeo. Esta é uma imagem de 25 pixels de altura com uma largura flexível que não pode exceder 170 pixels. Se você não fornecer esta imagem, o nome de seu canal será exibido, em vez de uma imagem.
brandingSettings.image.trackingImageUrl string
Essa propriedade foi descontinuada.

O URL para um pixel de rastreamento de 1 x 1 pixel que pode ser usado para coletar estatísticas de visualizações do canal ou das páginas de vídeo.
brandingSettings.image.bannerTabletLowImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de baixa resolução que é exibida na página do canal em aplicativos de tablet. O tamanho máximo da imagem é de 1138 x 188 pixels.
brandingSettings.image.bannerTabletImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner que é exibida na página do canal em aplicativos de tablet. A imagem tem 1.707 px por 283 px.
brandingSettings.image.bannerTabletHdImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de alta resolução exibida na página do canal em aplicativos de tablet. O tamanho máximo da imagem é de 2.276 px por 377 px.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de resolução extra-alta exibida na página do canal em aplicativos para tablet. O tamanho máximo da imagem é de 2560 x 424 pixels.
brandingSettings.image.bannerMobileLowImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de baixa resolução exibida na página do canal em aplicativos para celular. O tamanho máximo da imagem é de 320 x 88 pixels.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de média resolução exibida na página do canal em aplicativos móveis. O tamanho máximo da imagem é de 960 x 263 pixels.
brandingSettings.image.bannerMobileHdImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de alta resolução exibida na página do canal em aplicativos móveis. O tamanho máximo da imagem é de 1.280 x 360 pixels.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de resolução muito alta exibida na página do canal em aplicativos móveis. O tamanho máximo da imagem é de 1.440 px por 395 px.
brandingSettings.image.bannerTvImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de resolução extra-alta exibida na página do canal em aplicativos de televisão. O tamanho máximo da imagem é de 2.120 px por 1.192 px.
brandingSettings.image.bannerTvLowImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de baixa resolução exibida na página do canal em aplicativos de televisão. O tamanho máximo da imagem é de 854 x 480 pixels.
brandingSettings.image.bannerTvMediumImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de resolução média exibida na página do canal em aplicativos de televisão. O tamanho máximo da imagem é de 1.280 px por 720 px.
brandingSettings.image.bannerTvHighImageUrl string
Essa propriedade foi descontinuada.

O URL para uma imagem de banner de alta resolução exibida na página do canal em aplicativos de televisão. O tamanho máximo da imagem é de 1920 x 1080 pixels.
brandingSettings.image.bannerExternalUrl string
Esta propriedade especifica o local da imagem do banner que o YouTube usa para gerar os vários tamanhos de imagem de banner para um canal.
brandingSettings.hints[] list
Essa propriedade e todas as propriedades filhas dela foram descontinuadas.

O objeto hints encapsula outras propriedades de marca.
brandingSettings.hints[].property string
Essa propriedade foi descontinuada.

Uma propriedade.
brandingSettings.hints[].value string
Essa propriedade foi descontinuada.

O valor da propriedade.
auditDetails object
O objeto auditDetails encapsula os dados de canais que uma rede multicanal (RM) avaliaria ao determinar se um canal específico será aceito ou recusado. Qualquer solicitação de API que recupere essa parte do recurso precisa fornecer um token de autorização que contenha o escopo https://www.googleapis.com/auth/youtubepartner-channel-audit. Além disso, qualquer token que use esse escopo precisará ser revogado quando a RM decidir aceitar ou rejeitar o canal ou em até duas semanas após a data de emissão.
auditDetails.overallGoodStanding boolean
Esse campo indica se há algum problema com o canal. Atualmente, esse campo representa o resultado da operação lógica AND sobre as propriedades communityGuidelinesGoodStanding, copyrightStrikesGoodStanding e contentIdClaimsGoodStanding, o que significa que essa propriedade tem um valor true se todas elas também tiverem um valor true. No entanto, ela terá um valor false se alguma delas tiver o valor false. No entanto, a metodologia usada para definir o valor dessa propriedade está sujeita a mudanças.
auditDetails.communityGuidelinesGoodStanding boolean
Indica se o canal respeita as diretrizes da comunidade do YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
Indica se o canal tem avisos de direitos autorais.
auditDetails.contentIdClaimsGoodStanding boolean
Indica se o canal tem reivindicações não resolvidas.
contentOwnerDetails object
O objeto contentOwnerDetails encapsula os dados do canal que são visíveis apenas para o parceiro do YouTube que vinculou o canal ao Gerenciador de conteúdo.
contentOwnerDetails.contentOwner string
O ID do proprietário do conteúdo vinculado ao canal.
contentOwnerDetails.timeLinked datetime
A data e a hora em que o canal foi vinculado ao proprietário do conteúdo. O valor é especificado no formato ISO 8601.
localizations object
O objeto localizations encapsula as traduções dos metadados do canal.
localizations.(key) object
O idioma dos metadados localizados associados ao valor da chave. O valor é uma string que contém um código de idioma BCP-47.
localizations.(key).title string
O título localizado do canal.
localizations.(key).description string
A descrição localizada do canal.