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