Videos: rate

Ein Video mit „Mag ich“ oder „Mag ich nicht“ bewerten oder eine Bewertung entfernen

Kontingentauswirkungen: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

HINWEIS:Dies hat keine Auswirkungen auf die offizielle Anzahl der „Mag ich“- und „Mag ich nicht“-Bewertungen des Videos.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/videos/rate

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 die YouTube-Video-ID des Videos an, das bewertet wird oder dessen Bewertung entfernt wird.
rating	string Gibt die zu speichernde Bewertung an. Zulässige Werte: dislike – Gibt an, dass der authentifizierte Nutzer das Video mit „Mag ich nicht“ bewertet hat. like – Gibt an, dass der authentifizierte Nutzer das Video mit „Mag ich“ bewertet hat. none – Entfernt alle Bewertungen, die der authentifizierte Nutzer zuvor für das Video abgegeben hat.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode den HTTP-Antwortcode 204 (No Content) zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp	Fehlerdetails	Beschreibung
badRequest (400)	emailNotVerified	Der Nutzer muss seine E-Mail-Adresse bestätigen, bevor er eine Bewertung abgeben kann.
badRequest (400)	invalidRating	Die Anfrage enthielt einen unerwarteten Wert für den Parameter rating.
badRequest (400)	videoPurchaseRequired	Leihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben.
forbidden (403)	forbidden	Das Video, das Sie bewerten möchten, kann nicht bewertet werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403)	videoRatingDisabled	Der Inhaber des Videos, das Sie bewerten möchten, hat die Bewertungen für dieses Video deaktiviert.
notFound (404)	videoNotFound	Das Video, das Sie bewerten möchten, wurde nicht gefunden. Prüfen Sie den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

Testen!

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