Implementierung: Bewertungen

In den folgenden Beispielen wird gezeigt, 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 Bewertung eines Nutzers für ein Video einzureichen. Diese Anfrage muss mit OAuth 2.0 autorisiert werden.

Legen Sie in der Anfrage die folgenden beiden Parameter fest:

  • Der Parameter id gibt die YouTube-Video-ID des Videos an, das eine Altersfreigabe erhält oder dessen Altersfreigabe 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 und mit dem dritten Wert werden alle zuvor für den Nutzer vorhandenen Bewertungen entfernt.

In der folgenden Beispielanfrage wird dem Video der Keynote-Präsentation auf der Google I/O-Konferenz 2014 eine positive (mag ich)-Bewertung gegeben:

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

Bewertung eines Videos durch den aktuellen Nutzer abrufen

Mit der videos.getRating-Methode kannst du die Bewertung eines oder mehrerer Videos durch den aktuell authentifizierten Nutzer 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.

In der folgenden Beispielanfrage wird die Bewertung des aktuellen Nutzers für das Video der Keynote-Präsentation auf der Google I/O-Konferenz 2014 abgerufen. Wenn Sie das vorherige Beispiel im API Explorer ausgeführt haben, sollte die API-Antwort die Bewertung like enthalten.

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 kannst du eine Liste der Videos abrufen, die vom Nutzer bewertet wurden, der die API-Anfrage autorisiert hat. Der Parameterwert gibt an, ob Videos mit „Mag ich“ oder „Mag ich nicht“ abgerufen werden sollen.

In der folgenden Beispielanfrage wird eine Liste der Videos abgerufen, die der aktuelle Nutzer mit like bewertet hat. Die Anfrage muss mit OAuth 2.0 autorisiert sein.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Hinweis:Du kannst auch eine Liste der Videos abrufen, die dem Nutzer gefallen haben (aber nicht der Liste der Videos, die ihm nicht gefallen). Folge dazu der Anleitung zum Abrufen der Lieblingsvideos eines Kanals. Rufe in Schritt 1 dieses Prozesses nicht die Playlist-ID für die Lieblingsvideos des Kanals ab, sondern die Playlist-ID für die Videos, die dem Kanal gefallen. Das Attribut contentDetails.relatedPlaylists.likes enthält den Wert.

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