Un recurso channelBanner
contiene la URL que usarías para establecer 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 de banner del canal a YouTube. Este método representa los dos primeros pasos de un proceso de tres pasos para actualizar la imagen del banner de un canal:
- Llama al método
channelBanners.insert
para subir los datos de la imagen binaria a YouTube. La imagen debe tener una relación de aspecto de 16:9 y un tamaño mínimo de 2048 x 1152 píxeles. Te recomendamos que subas una imagen de 2560 × 1440 px. - Extrae el valor de la propiedad
url
de la respuesta que muestra la API para el paso 1. - Llama al método
channels.update
para actualizar la configuración de desarrollo de la marca del canal. Establece el valor de la propiedadbrandingSettings.image.bannerExternalUrl
en la URL que obtuviste 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 Es la etiqueta de Etag de este recurso. |
url |
string Es 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. |