Videos: rate

Du kannst einem Video eine „Mag ich“- oder „Mag ich nicht“-Bewertung hinzufügen oder eine Bewertung für ein Video entfernen.

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

HINWEIS: Dies hat keinen Einfluss auf die offizielle Anzahl von „Mag ich“- und „Mag ich nicht“-Bewertungen für das Video.

Gängige Anwendungsfälle

Anfragen

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).

Umfang
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 gerade bewertet wird oder dessen Bewertung entfernt wurde.
rating	string Gibt die zu erfassende Bewertung an. Zulässige Werte sind: dislike: Zeichnet auf, dass dem authentifizierten Nutzer das Video gefallen hat. like: Zeichnet auf, dass dem authentifizierten Nutzer das Video gefallen hat. none: Entfernt alle Altersfreigaben, die der authentifizierte Nutzer zuvor für das Video festgelegt hatte.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, gibt diese Methode einen 204-HTTP-Antwortcode (No Content) zurück.

Fehler

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

Fehlertyp	Fehlerdetails	Beschreibung
badRequest (400)	emailNotVerified	Der Nutzer muss vor der Bewertung seine E-Mail-Adresse bestätigen.
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 du bewerten möchtest, kann nicht bewertet werden. Die Anfrage ist möglicherweise nicht korrekt autorisiert.
forbidden (403)	videoRatingDisabled	Der Inhaber des Videos, das du bewerten möchtest, hat die Altersfreigabe für dieses Video deaktiviert.
notFound (404)	videoNotFound	Das Video, das du bewerten möchtest, wurde nicht gefunden. Prüfe, ob der Wert des id-Parameters der Anfrage korrekt ist.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.