Un recurso channelBanner
contiene la URL que usarías para configurar una imagen recién subida como la imagen de banner de un canal.
Métodos
La API admite los siguientes métodos para los recursos de 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 de banner de un canal:
- Invoca el método
channelBanners.insert
para subir los datos de imágenes binarias a YouTube. La imagen debe tener una proporción de 16:9 y tener al menos 2048 x 1152 píxeles. Te recomendamos que subas 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 de marca del canal. Establece el valor de la propiedadbrandingSettings.image.bannerExternalUrl
en la URL obtenida en el paso 2.
- Invoca el método
Representación de recursos
La siguiente estructura JSON 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 API. El valor será youtube#channelBannerResource . |
etag |
etag Es la 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 de banner de un canal. |