Poniższe przykłady pokazują, jak używać interfejsu YouTube Data API (v3) do obsługi funkcji związanych z ocenami filmów.
Oceń film wideo
Wywołaj metodę videos.rate
, aby przesłać ocenę użytkownika dla filmu. To żądanie musi zostać autoryzowane przez OAuth 2.0.
Ustaw w żądaniu te 2 parametry:
- Parametr
id
określa identyfikator filmu w YouTube, który jest oceniany (lub usuwa jego ocenę). - Parametr
rating
określa ocenę, jaką użytkownik autoryzujący chce zarejestrować. Prawidłowe wartości tolike
,dislike
inone
. Pierwsze dwie wartości określają ocenę, a trzecia usuwa wszystkie oceny przypisane wcześniej użytkownikowi.
Przykładowe żądanie przedstawia pozytywną (podobną) ocenę Przemówienia podczas konferencji Google I/O w 2014 r.:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
Pobieranie oceny filmu bieżącego użytkownika
Metoda videos.getRating
pozwala pobrać ocenę jednego lub wielu filmów aktualnie uwierzytelnionego użytkownika. W żądaniu ustaw wartość parametru id
na rozdzieloną przecinkami listę identyfikatorów filmów w YouTube dla zasobów, dla których pobierasz dane o ocenach. Pamiętaj, że to żądanie musi być autoryzowane przez OAuth 2.0.
Przykładowe żądanie poniżej zawiera ocenę bieżącego filmu użytkownika podczas prezentacji Google I/O w 2014 roku. (Jeśli poprzedni przykład został uruchomiony w eksploratorze interfejsów API, odpowiedź interfejsu API powinna wskazywać, że ocena to like
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
Pobierz filmy ocenione przez obecnego użytkownika
Parametr myRating
metody videos.list
pozwala pobrać listę filmów ocenionych przez użytkownika, który autoryzował żądanie do interfejsu API. Wartość parametru wskazuje, czy chcesz pobierać filmy, które Ci się podobają lub nie.
Poniżej znajduje się przykład żądania, które pobiera listę filmów, którym bieżący użytkownik przyznał ocenę like
. Żądanie musi być autoryzowane przez OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
contentDetails.relatedPlaylists.likes
zawiera wartość.Interfejs API umożliwia pobieranie listy filmów, które podobały się użytkownikowi za pomocą metody
videos.list
lub playlistItems.list
. Ponieważ w zasobie video
zwracane są inne informacje niż w zasobie playlistItem
, możesz wybrać metodę, która najlepiej odpowiada Twoim potrzebom.