ChannelBanners: insert

Importe une image de bannière de chaîne sur YouTube. Cette méthode représente les deux premières étapes d'un processus en trois étapes pour mettre à jour l'image de bannière d'un canal:

1. Appelez la méthode channelBanners.insert pour mettre en ligne les données d'image binaires sur YouTube. L'image doit être au format 16:9 et mesurer au moins 2 048 x 1 152 pixels. Nous vous recommandons d'importer une image de 2 560 x 1 440 pixels.
2. Extrayez la valeur de la propriété url de la réponse renvoyée par l'API pour l'étape 1.
3. Appelez la méthode channels.update pour mettre à jour les paramètres de branding de la chaîne. Définissez la valeur de la propriété brandingSettings.image.bannerExternalUrl sur l'URL obtenue à l'étape 2.

Cette méthode est compatible avec l'importation de contenus multimédias. Les fichiers importés doivent respecter les contraintes suivantes:

• Taille maximale des fichiers:6 Mo
• Types MIME multimédias acceptés:image/jpeg, image/png, application/octet-stream

Impact sur les quotas:un appel à cette méthode a un coût de quota de 50 unités.

Requête

Requête HTTP

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants. Pour en savoir plus sur l'authentification et l'autorisation, consultez Implémenter l'autorisation OAuth 2.0.

Portée
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres facultatifs
onBehalfOfContentOwner	string Ce paramètre ne peut être utilisé que dans une requête autorisée appropriée. Remarque:Ce paramètre est destiné exclusivement aux partenaires de contenus YouTube. Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube agissant au nom du propriétaire du contenu spécifié dans la valeur du paramètre. Ce paramètre est destiné aux partenaires de contenus YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenus de s'authentifier une seule fois et d'accéder à toutes leurs données vidéo et de chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie une ressource channelBanner dans le corps de la réponse.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel de cette méthode. Pour en savoir plus, consultez API YouTube Data - Erreurs.

Type d'erreur	Détail de l'erreur	Description
badRequest (400)	bannerAlbumFull	Votre album d'illustrations de chaîne YouTube contient trop d'images. Pour résoudre ce problème, accédez à Google Photos, puis à la page des albums et supprimez certaines images de cet album.
badRequest (400)	mediaBodyRequired	La requête n'inclut pas le contenu de l'image.

Essayer

Utilisez APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.