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 sindlike
,dislike
undnone
. 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
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.