Récupère les notes attribuées par l'utilisateur autorisé à une liste de vidéos spécifiées.
Impact du quota : un appel à cette méthode a un coût de quota de 1 unité.
Cas d'utilisation courants
Demande
Requête HTTP :
GET https://www.googleapis.com/youtube/v3/videos/getRating
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
Portée |
---|
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 listés sont des paramètres de requête.
Paramètres | ||
---|---|---|
Réglages obligatoires | ||
id |
string Le paramètre id spécifie une liste d'ID vidéo YouTube séparés par des virgules pour la ou les ressources dont vous récupérez les données d'évaluation. Dans une ressource video , la propriété id spécifie l'ID de la vidéo. |
|
Paramètres facultatifs | ||
onBehalfOfContentOwner |
string Ce paramètre ne peut être utilisé que dans une requête correctement autorisée. 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 différentes. Elle permet aux propriétaires de contenu de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants pour chaque chaîne. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié. |
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 corps de réponse présentant la structure suivante :
{ "kind": "youtube#videoGetRatingResponse", "etag": etag, "items": [ { "videoId": string, "rating": string } ] }
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 ressource de l'API. La valeur sera youtube#videoGetRatingResponse . |
etag |
etag ETag de cette ressource. |
items[] |
list Liste de notes correspondant aux critères de requête. |
items[].videoId |
string ID que YouTube utilise pour identifier la vidéo de façon unique. |
items[].rating |
string Note attribuée par l'utilisateur autorisé à la vidéo. Valeurs valides pour cette propriété :
|
Erreurs
L'API ne définit aucun message d'erreur unique à cette méthode d'API. Toutefois, cette méthode peut toujours renvoyer des erreurs générales d'API répertoriées dans la documentation sur les messages d'erreur.
Essayer
Utilisez APIs Explorer pour appeler cette API et afficher la requête API et la réponse.