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

Impact sur le quota: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/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 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 obligatoires
part string

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

Si le paramètre identifie une propriété qui contient les propriétés enfants, les propriétés enfants sera incluse dans la réponse.
Paramètres facultatifs
onBehalfOfContentOwner
string Ce paramètre ne peut être utilisé que dans une demande correctement autorisée. Remarque:Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.

Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube agissant pour le compte du propriétaire de 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. Elle permet aux propriétaires de contenu de s'authentifier une fois et d'accéder à toutes les données de leurs vidéos et de leur 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é.
onBehalfOfContentOwnerChannel
string Ce paramètre ne peut être utilisé que dans une demande correctement autorisée. Remarque:Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.

Les Paramètre onBehalfOfContentOwnerChannel spécifie l'ID de la chaîne YouTube sur laquelle la vidéo est diffusée. ajouté. Ce paramètre est obligatoire lorsqu'une requête spécifie une valeur pour le paramètre onBehalfOfContentOwner, qui ne peut être utilisé que dans conjointement avec ce paramètre. De plus, la demande doit être autorisé à l'aide d'un compte CMS associé au propriétaire de contenu spécifie le paramètre onBehalfOfContentOwner. Enfin, la fonction canal auquel la valeur du paramètre onBehalfOfContentOwnerChannel a été définie spécifie doit être associée au propriétaire de contenu onBehalfOfContentOwner est spécifié.

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

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 les propriétés suivantes:

    • snippet.width
    • snippet.height

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "playlistImages" dans le corps de la réponse.