Thumbnails: set

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

Cette méthode est compatible avec la mise en ligne de contenus multimédias. Les fichiers mis en ligne doivent respecter les contraintes suivantes :

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

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

Cas d'utilisation courants

Requête

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

Champ d'application
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 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
videoId string
Le paramètre videoId spécifie un ID de vidéo YouTube pour lequel la miniature vidéo personnalisée est fournie.
Paramètres facultatifs
onBehalfOfContentOwner string
Remarque: Ce paramètre est exclusivement destiné 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éo et de chaîne, sans avoir à fournir d'identifiants d'authentification 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 l'image miniature que vous mettez en ligne. Le corps de la requête ne contient pas de 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 peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur Détails de l'erreur Description
badRequest (400) invalidImage Le contenu de l'image fourni n'est pas valide.
badRequest (400) mediaBodyRequired La requête n'inclut pas le contenu de l'image.
forbidden (403) forbidden La miniature ne peut pas être définie pour la vidéo spécifiée. Il est possible que la requête ne soit pas correctement autorisée.
forbidden (403) forbidden L'utilisateur authentifié n'est pas autorisé à mettre en ligne et à définir des miniatures vidéo personnalisées.
notFound (404) videoNotFound La vidéo pour laquelle vous essayez d'insérer une image miniature est introuvable. Vérifiez la valeur du paramètre videoId de la requête pour vous assurer qu'elle est correcte.
tooManyRequests (429) uploadRateLimitExceeded La chaîne a mis en ligne trop de miniatures récemment. Veuillez réessayer ultérieurement.

Essayer

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