Videos: rate

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

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

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

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

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 oder entfernt wurde.
rating string
Gibt die Altersfreigabe an, die aufgezeichnet werden soll.

Zulässige Werte sind:
  • dislike: Zeichnet auf, dass dem authentifizierten Nutzer das Video gefallen hat.
  • like: Es wird angegeben, 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, wird mit dieser Methode ein HTTP-204-Antwortcode (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, 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 ordnungsgemäß 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üfen Sie, 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.