Ajoutez une note sur "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimez la note attribuée à une vidéo.
Impact sur les quotas: un appel à cette méthode a un coût de quota de 50 unités.
REMARQUE:Cela n'a aucune incidence sur le nombre officiel de "J'aime" et "Je n'aime pas" de la vidéo.
Cas d'utilisation courants
Requête
Requête HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
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
Définition du champ d'application |
---|
https://www.googleapis.com/auth/youtubepartner |
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 | ||
id |
string Le paramètre id spécifie l'ID vidéo YouTube de la vidéo évaluée ou dont la classification est en cours de suppression. |
|
rating |
string Spécifie la classification à enregistrer. Les valeurs acceptées sont les suivantes :
|
Corps de la requête
Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un code de réponse HTTP 204
(No Content
).
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) |
emailNotVerified |
L'utilisateur doit valider son adresse e-mail avant de donner son avis. |
badRequest (400) |
invalidRating |
La requête contenait une valeur inattendue pour le paramètre rating . |
badRequest (400) |
videoPurchaseRequired |
Seuls les utilisateurs qui ont loué des vidéos peuvent les évaluer. |
forbidden (403) |
forbidden |
Impossible d'évaluer la vidéo. Il est possible que la requête ne soit pas correctement autorisée. |
forbidden (403) |
videoRatingDisabled |
Le propriétaire de la vidéo que vous essayez d'évaluer a désactivé les avis sur cette vidéo. |
notFound (404) |
videoNotFound |
Impossible de trouver la vidéo que vous essayez d'évaluer. Vérifiez que la valeur du paramètre id de la requête est correcte. |
Essayer
Utilisez APIs Explorer pour appeler cette API et afficher la requête et la réponse d'API.