Videos: rate

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 :
  • dislike : enregistre que l'utilisateur authentifié n'a pas aimé la vidéo.
  • like : enregistre que l'utilisateur authentifié a aimé la vidéo.
  • none : supprime toute classification précédemment définie par l'utilisateur authentifié pour la vidéo.

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.