Implementierung: Bewertungen

In den folgenden Beispielen wird gezeigt, wie Sie mit der YouTube Data API (Version 3) Funktionen im Zusammenhang mit Videobewertungen ausführen.

Video bewerten

Rufen Sie die Methode videos.rate auf, um die Bewertung eines Nutzers für ein Video einzureichen. Diese Anfrage muss mit OAuth 2.0 autorisiert werden.

Legen Sie die folgenden zwei Parameter in Ihrer Anfrage fest:

  • Der Parameter id gibt die YouTube-Video-ID des Videos an, das bewertet wird (oder seine Bewertung entfernt).
  • Der Parameter rating gibt die Bewertung an, die der Nutzer, der die Anfrage autorisiert, aufnehmen möchte. Gültige Parameterwerte sind like, dislike und none. Mit den ersten beiden Werten wird eine Bewertung festgelegt. Mit dem dritten Wert werden alle Bewertungen entfernt, die zuvor für den Nutzer vorhanden waren.

Die folgende Beispielanfrage hat eine positive (positive) Bewertung für das Video der Keynote-Rede auf der Google I/O-Konferenz 2014 erhalten:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

Bewertung des aktuellen Nutzers eines Videos abrufen

Mit der Methode videos.getRating kannst du die Bewertung des derzeit authentifizierten Nutzers für ein oder mehrere Videos abrufen. Legen Sie in der Anforderung den Wert des Parameters id auf eine durch Kommas getrennte Liste der YouTube-Video-IDs für die Ressourcen fest, für die Sie Bewertungsdaten abrufen. Diese Anfrage muss mit OAuth 2.0 autorisiert werden.

Die folgende Beispielanfrage ruft die Bewertung des aktuellen Nutzers des Videos der Keynote-Rede auf der Google I/O-Konferenz 2014 ab. Wenn Sie das vorherige Beispiel im APIs Explorer ausgeführt haben, sollte in der API-Antwort angegeben werden, dass die Bewertung like ist.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

Videos abrufen, die vom aktuellen Nutzer bewertet wurden

Mit dem Parameter myRating der Methode videos.list können Sie eine Liste der Videos abrufen, die vom Nutzer autorisiert wurden, der die API-Anfrage autorisiert. Der Parameterwert gibt an, ob du mit „Mag ich“ oder „Mag ich nicht“ bewertete Videos abrufen möchtest.

Die folgende Beispielanfrage ruft eine Liste der Videos ab, für die der aktuelle Nutzer eine like-Bewertung abgegeben hat. Die Anfrage muss mit OAuth 2.0 autorisiert werden.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Hinweis: Du kannst auch eine Liste der Videos mit „Mag ich“- und „Mag ich nicht“-Bewertungen eines Nutzers abrufen. Eine Anleitung dafür findest du im Hilfeartikel Lieblingsvideos auf einem Kanal ansehen. In Schritt 1 dieses Vorgangs wird die Playlist-ID für die mit „Mag ich“ bewerteten Videos abgerufen, anstatt die Playlist-ID für die Lieblingsvideos des Kanals abzurufen. Die Eigenschaft contentDetails.relatedPlaylists.likes enthält den Wert.

So kannst du mit der API eine Liste der Videos abrufen, die den Nutzern entweder mit der Methode videos.list oder mit der Methode playlistItems.list gefallen haben. Da in einer video-Ressource andere Informationen als eine playlistItem-Ressource zurückgegeben werden, können Sie die Methode auswählen, die Ihren Anforderungen am besten entspricht.