PlaylistImages: insert

Ajoute une image à une playlist.

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 : 50 Mo
  • Format accepté : 1:1 (carré)
  • Types MIME de contenus multimédias acceptés : image/jpeg, image/png

Impact sur le quota : un appel à cette méthode coûte 50 unités de quota.

Requête

Requête HTTP

POST https://www.googleapis.com/youtube/v3/playlistImages

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation

Champ d'application
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant présente 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 obligatoires
part string

Le paramètre part spécifie une liste de une ou plusieurs propriétés de ressources playlistImage séparées par une virgule que la réponse de l'API inclura.

Si le paramètre identifie une propriété contenant des propriétés enfants, ces dernières seront incluses dans la réponse.
Paramètres facultatifs
onBehalfOfContentOwner string
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Remarque : Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.

Le onBehalfOfContentOwner paramètre indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre. Ce paramètre est destiné aux partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes leurs données de vidéos et de chaînes, 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 du contenu YouTube spécifié.
onBehalfOfContentOwnerChannel string
Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. Remarque : Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.

Le onBehalfOfContentOwnerChannelparamètre spécifie l'ID de la chaîne YouTube à laquelle une vidéo est ajoutée. Ce paramètre est obligatoire lorsqu'une requête spécifie une valeur pour le onBehalfOfContentOwner paramètre, et il ne peut être utilisé qu'en conjonction avec ce paramètre. De plus, la requête doit être autorisée à l'aide d'un compte CMS associé au propriétaire du contenu spécifié par le onBehalfOfContentOwner paramètre. Enfin, la chaîne spécifiée par la valeur du paramètre onBehalfOfContentOwnerChannel doit être associée au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.

Ce paramètre est destiné aux partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'effectuer des actions au nom de la chaîne spécifiée dans la valeur du paramètre sans avoir à fournir d'identifiants d'authentification pour chaque chaîne distincte.

Corps de la requête

Fournissez une ressource playlistImages dans le corps de la requête.

Pour cette ressource :

  • Vous devez spécifier une valeur pour ces propriétés :

    • snippet.playlistId
    • snippet.type

  • Vous pouvez définir des valeurs pour ces propriétés :

    • snippet.width
    • snippet.height

Réponse

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