Thumbnails: set

met en ligne une miniature personnalisée sur YouTube et la définit pour une vidéo ;

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

  • Taille maximale du fichier:2 Mo
  • Types MIME de mé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 d'environ 50 unités.

Cas d'utilisation courants

Demande

Requête HTTP :

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

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

Portée
https://www.googleapis.com/auth/youtubepartner
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
Réglages obligatoires
videoId string
Le paramètre videoId spécifie l'ID vidéo YouTube pour lequel la miniature vidéo personnalisée est fournie.
Paramètres facultatifs
onBehalfOfContentOwner string
Remarque : Ce paramètre est réservé aux partenaires de contenu YouTube.

Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube qui agit au nom 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 différentes. Elle permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants pour chaque chaîne. Le compte CMS réel avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

Corps de la requête

Le corps de la requête contient la vignette que vous importez. Le corps de la requête ne contient aucune ressource thumbnail.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind string
Identifie le type de ressource de l'API. La valeur sera youtube#thumbnailSetResponse.
etag etag
ETag de cette ressource.
items[] list
Liste de miniatures.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API pourrait renvoyer en réponse à un appel à cette méthode. Veuillez consulter la documentation sur les messages d'erreur pour en savoir plus.

Type d'erreur Détails de l'erreur Description
badRequest (400) invalidImage Le contenu de l'image fournie n'est pas valide.
badRequest (400) mediaBodyRequired La requête n'inclut pas le contenu de l'image.
forbidden (403) forbidden Impossible de définir la miniature pour la vidéo spécifiée. Il est possible que la demande ne soit pas autorisée correctement.
forbidden (403) forbidden L'utilisateur authentifié ne dispose pas des autorisations nécessaires pour importer et définir des miniatures de vidéo personnalisées.
notFound (404) videoNotFound Impossible de trouver la vidéo pour laquelle vous essayez d'insérer une vignette. Vérifiez que la valeur du paramètre videoId de la requête est correcte.

Essayer

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