Implementierung: Bewertungen

Die folgenden Beispiele zeigen, wie du mit der YouTube Data API (Version 3) Funktionen im Zusammenhang mit Videobewertungen ausführen kannst.

Video bewerten

Rufe die Methode videos.rate auf, um die Nutzerbewertung für ein Video zu senden. Diese Anfrage muss mit OAuth 2.0 autorisiert werden.

Legen Sie in Ihrer Anfrage die folgenden beiden Parameter fest:

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

Mit der folgenden Beispielanfrage wird das Video der Keynote auf der Google I/O-Konferenz 2014 positiv bewertet:

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

Aktuelle Nutzerbewertung eines Videos abrufen

Mit der Methode videos.getRating kannst du die Bewertung des aktuell authentifizierten Nutzers für ein oder mehrere Videos abrufen. Legen Sie in Ihrer Anfrage den Wert des Parameters id auf eine durch Kommas getrennte Liste von 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 für das Video der Keynote 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 sein, dass die Bewertung like lautet.

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

Vom aktuellen Nutzer bewertete Videos abrufen

Mit dem Parameter myRating der Methode videos.list kannst du eine Liste der Videos abrufen, die von dem Nutzer bewertet wurden, der die API-Anfrage autorisiert hat. Der Parameterwert gibt an, ob du Videos abrufen möchtest, die du mit „Mag ich“ oder „Mag ich nicht“ bewertet hast.

Mit der folgenden Beispielanfrage wird eine Liste von Videos abgerufen, die der aktuelle Nutzer mit like bewertet 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“ (aber nicht mit „Mag ich“) des Nutzers abrufen, indem du die Lieblingsvideos eines Kanals aufrufst. Rufe in Schritt 1 dieses Vorgangs nicht die Playlist-ID für die Lieblingsvideos des Kanals ab, sondern die Playlist-ID für die Videos, die auf dem Kanal mit „Mag ich“ bewertet wurden. Die Eigenschaft contentDetails.relatedPlaylists.likes enthält den Wert.

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