Videos: rate

Ajoutez une mention "J'aime" ou "Je n'aime pas" à une vidéo, ou supprimez-en une.

Incidence sur le quota : un appel à cette méthode coûte 50 unités de quota.

REMARQUE : Cela n'a aucune incidence sur le nombre officiel de mentions "J'aime" ou "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 acceptés par cette requête. Tous les paramètres listé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 à laquelle une note est ajoutée ou dont la note est supprimée.
rating string
Spécifie la mention à enregistrer.

Les valeurs acceptables 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 mention que l'utilisateur authentifié avait précédemment définie 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

En cas de réussite, 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 d'ajouter une mention.
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 La vidéo que vous essayez d'évaluer ne peut pas être évaluée. 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 mentions pour cette vidéo.
notFound (404) videoNotFound La vidéo que vous essayez d'évaluer est introuvable. Vérifiez la valeur du paramètre id de la requête pour vous assurer qu'elle est correcte.

Essayer

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