Wdrożenie: oceny

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 to like, dislike i none. 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
Uwaga: możesz też pobrać listę filmów podobających się użytkownikowi (ale nie tych, które mi się nie podobają), wykonując procedurę pobierania ulubionych filmów z kanału. W kroku 1 procesu zamiast pobierać identyfikator playlisty z ulubionymi filmami, pobierz identyfikator playlisty, która Ci się podoba. Właściwość 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.