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 permet d'importer des 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

Quota: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

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 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 YouTube différentes. Elle permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes les données vidéo et de chaîne, sans avoir à fournir d'identifiants pour chaque chaîne. Le compte CMS actuel 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 la ressource 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. Consultez 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 requête 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 vidéo 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 La chaîne a récemment mis en ligne trop de miniatures. Veuillez réessayer plus tard.

Essayer

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