Videos: rate

Attribuer une mention "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimer une note sur une vidéo

Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.

REMARQUE:Cela n'affecte pas 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

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 YouTube de la vidéo évaluée ou dont la classification est supprimée.
rating string
Spécifie la note à enregistrer.

Les valeurs acceptées sont les suivantes :
  • dislike : indique 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

Lorsque cette méthode fonctionne, elle 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 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) emailNotVerified L'utilisateur doit valider son adresse e-mail avant de l'évaluer.
badRequest (400) invalidRating La requête contenait une valeur inattendue pour le paramètre rating.
badRequest (400) videoPurchaseRequired Les vidéos en location ne peuvent être évaluées que par les utilisateurs qui les ont louées.
forbidden (403) forbidden Impossible de donner votre avis sur la vidéo que vous tentez d'évaluer. La requête n'a peut-être pas été autorisée correctement.
forbidden (403) videoRatingDisabled Le propriétaire de la vidéo que vous tentez d'évaluer a désactivé les avis sur cette vidéo.
notFound (404) videoNotFound La vidéo que vous essayez d'évaluer est introuvable. 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 de l'API.