Videos: getRating

Ruft die Bewertungen ab, die der autorisierte Nutzer einer Liste angegebener Videos gegeben hat.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 1 Kontingenteinheit.

Gängige Anwendungsfälle

Anfrage

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
https://www.googleapis.com/auth/youtube.readonly

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 Ressourcen an, für die Sie Bewertungsdaten abrufen. In einer video-Ressource gibt die Property id die ID des Videos 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-Content-Partner vorgesehen. Der onBehalfOfContentOwner Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Content-Inhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können sich Rechteinhaber einmal authentifizieren und auf alle 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 sind die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
kind	string Gibt den Typ der API-Ressource an. Der Wert ist youtube#videoGetRatingResponse.
etag	etag Das ETag dieser Ressource.
items[]	list Eine Liste von Bewertungen, die den Suchkriterien entsprechen.
items[].videoId	string Die ID, die YouTube verwendet, um das Video eindeutig zu identifizieren.
items[].rating	string Die Bewertung, die der autorisierte Nutzer dem Video gegeben hat. Gültige Werte für diese Property sind: dislike like none unspecified

Fehler

Die API definiert keine Fehlermeldungen, die für diese API-Methode spezifisch sind. Diese Methode kann jedoch allgemeine API-Fehler zurückgeben, die in der Fehlermeldungs-Dokumentation aufgeführt sind.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.