Ruft die Bewertungen ab, die der autorisierte Nutzer für eine Liste bestimmter Videos abgegeben hat.
Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.
Gängige Anwendungsfälle
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/youtube/v3/videos/getRating
Autorisierung
Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).
Bereich |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parameter
In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.
Parameter | ||
---|---|---|
Erforderliche Parameter | ||
id |
string Der Parameter id gibt eine durch Kommas getrennte Liste der YouTube-Video-IDs für die Ressource(n) an, für die Sie Bewertungsdaten abrufen. In einer video -Ressource gibt die id -Eigenschaft die Video-ID an. |
|
Optionale Parameter | ||
onBehalfOfContentOwner |
string Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen. Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich nur einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein. |
Anfragetext
Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "youtube#videoGetRatingResponse", "etag": etag, "items": [ { "videoId": string, "rating": string } ] }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#videoGetRatingResponse . |
etag |
etag Das ETag dieser Ressource. |
items[] |
list Eine Liste der Bewertungen, die den Kriterien der Anfrage entsprechen. |
items[].videoId |
string Die ID, mit der YouTube das Video eindeutig identifiziert. |
items[].rating |
string Die Bewertung, die der autorisierte Nutzer dem Video gegeben hat. Gültige Werte für diese Eigenschaft sind:
|
Fehler
Die API definiert keine Fehlermeldungen, die nur für diese API-Methode gelten. Bei dieser Methode können jedoch weiterhin allgemeine API-Fehler zurückgegeben werden, die in der Dokumentation zu Fehlermeldungen aufgeführt sind.
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.