Un recurso channelBanner
contiene la URL que usarías para configurar una imagen recién subida como la imagen del banner de un canal.
Métodos
La API admite los siguientes métodos para los recursos channelBanners
:
- insertar
- Sube una imagen del banner del canal a YouTube. Este método representa los dos primeros pasos de un proceso de tres pasos para actualizar la imagen de banner de un canal:
- Llama al método
channelBanners.insert
para subir los datos de imágenes binarias a YouTube. La imagen debe tener una relación de aspecto de 16:9 y tener, al menos, 2,048 × 1,152 píxeles. Te recomendamos subir una imagen de 2560 px por 1440 px. - Extrae el valor de la propiedad
url
de la respuesta que la API muestra para el paso 1. - Llama al método
channels.update
para actualizar la configuración del desarrollo de la marca del canal. Establece el valor de la propiedadbrandingSettings.image.bannerExternalUrl
en la URL obtenida en el paso 2.
- Llama al método
Representación de recursos
En la siguiente estructura JSON, se muestra el formato de un recurso channelBanners
:
{ "kind": "youtube#channelBannerResource", "etag": etag, "url": string }
Propiedades
La siguiente tabla define las propiedades que aparecen en este recurso:
Propiedades | |
---|---|
kind |
string Identifica el tipo de recurso de la API. El valor será youtube#channelBannerResource . |
etag |
etag La Etag de este recurso. |
url |
string La URL de la imagen del banner. Después de llamar al método channelBanners.insert , extrae este valor de la respuesta de la API. Luego, llama al método channels.update y establece la URL como el valor de la propiedad brandingSettings.image.bannerExternalUrl para establecer la imagen del banner de un canal. |