Thumbnails: set

Met en ligne une miniature de vidéo 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 des fichiers: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 entraîne un coût du quota d'environ 50 unités.

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 répertorie les paramètres compatibles avec cette requête. Tous les paramètres répertoriés sont des paramètres de requête.

Paramètres
Paramètres 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 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 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 un grand nombre de chaînes YouTube. Il 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 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

Le corps de la requête contient la vignette que vous importez. 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 d'API. La valeur est youtube#thumbnailSetResponse.
etag etag
Etag de cette ressource.
items[] list
Liste de vignettes.

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 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 Impossible de définir la miniature pour la vidéo spécifiée. La requête n'a peut-être pas été autorisée correctement.
forbidden (403) forbidden L'utilisateur authentifié n'est pas autorisé à mettre en ligne ni à définir des miniatures de vidéos personnalisées.
notFound (404) videoNotFound La vidéo pour laquelle vous essayez d'insérer une vignette est introuvable. Vérifiez que la valeur du paramètre videoId de la requête est correcte.
tooManyRequests (429) uploadRateLimitExceeded Trop de miniatures ont été mises en ligne sur cette chaîne récemment. Veuillez réessayer plus tard.

Essayer

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