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.