Um recurso channelBanner contém o URL que você usaria para definir uma imagem recém-enviada como a imagem de banner de um canal.
Métodos
A API oferece suporte aos seguintes métodos para recursos channelBanners:
- inserir
- Faz o upload de uma imagem do banner do canal no YouTube. Esse método representa as duas primeiras etapas de um processo de três etapas para atualizar a imagem do banner de um canal:
- Chame o método
channelBanners.insertpara enviar os dados de imagem binária ao YouTube. A imagem precisa ter uma proporção de 16:9 e pelo menos 2.048 x 1.152 pixels. Recomendamos enviar uma imagem de 2560 x 1440 pixels. - Extraia o valor da propriedade
urlda resposta que a API retorna para a etapa 1. - Chame o método
channels.updatepara atualizar as configurações de branding do canal. Defina o valor da propriedadebrandingSettings.image.bannerExternalUrlcomo o URL recebido na etapa 2.
- Chame o método
Representação de recurso
A estrutura JSON a seguir mostra o formato de um recurso channelBanners:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
| Propriedades | |
|---|---|
kind |
stringIdentifica o tipo do recurso da API. O valor será youtube#channelBannerResource. |
etag |
etagA Etag deste recurso. |
url |
stringO URL da imagem do banner. Depois de chamar o método channelBanners.insert, extraia esse valor da resposta da API. Em seguida, chame o método channels.update e defina o URL como o valor da propriedade brandingSettings.image.bannerExternalUrl para definir a imagem do banner de um canal. |