Implementacja: oceny

W przykładach poniżej pokazujemy, jak używać interfejsu YouTube Data API (v3) do wykonywania funkcji związanych z ocenianiem filmów.

Oceń film wideo

Wywołaj metodę videos.rate, aby przesłać ocenę filmu użytkownika. To żądanie musi być autoryzowane za pomocą protokołu OAuth 2.0.

Ustaw w żądaniu te 2 parametry:

  • Parametr id określa identyfikator filmu w YouTube, który został oceniony (lub którego ocena została usunięta).
  • Parametr rating określa ocenę, którą chce zarejestrować użytkownik autoryzujący żądanie. Prawidłowe wartości parametrów to like, dislike i none. Pierwsze dwie wartości określają ocenę, a trzecia usuwa wszelkie dotychczasowe oceny użytkownika.

Poniższy przykładowy wniosek daje pozytywną ocenę (podoba) filmowi z przemówienia, które odbyło się na konferencji Google I/O w 2014 roku:

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

Pobierz ocenę filmu obecnego użytkownika

Metoda videos.getRating umożliwia pobranie oceny jednego lub wielu filmów aktualnie uwierzytelnionego użytkownika. W swoim żądaniu ustaw wartość parametru id na listę identyfikatorów filmów YouTube, dla których pobierasz dane o ocenach. W tym celu podaj oddzieloną przecinkami listę identyfikatorów filmów w YouTube. Uwaga: to żądanie musi być autoryzowane za pomocą protokołu OAuth 2.0.

Widoczne poniżej przykładowe żądanie pobiera ocenę bieżącego użytkownika dotyczącą filmu przemówienia przemówienia na konferencji Google I/O w 2014 roku. Jeśli poprzedni przykład został wykonany w narzędziu Google APIs Explorer, 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 bieżącego użytkownika

Parametr myRating metody videos.list umożliwia pobranie listy filmów ocenionych przez użytkownika, który autoryzował żądanie do interfejsu API. Wartość tego parametru wskazuje, czy chcesz pobierać filmy, które Ci się podobają czy nie.

Przykładowe żądanie poniżej pobiera listę filmów, którym bieżący użytkownik przyznał ocenę like. Żądanie musi być autoryzowane za pomocą protokołu OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Uwaga: aby uzyskać listę filmów, które użytkownik polubił (ale nie nie), postępuj zgodnie z procedurą pobierania ulubionych filmów z kanału. W kroku 1 zamiast pobierać identyfikator playlisty z ulubionymi filmami z kanału, możesz pobrać identyfikator playlisty z filmami z kanału, które Ci się podobają. Właściwość contentDetails.relatedPlaylists.likes zawiera wartość.

Interfejs API pozwala więc pobrać listę filmów, które spodobały się użytkownikowi, metodą videos.list lub playlistItems.list. Zasób video zwraca inne informacje niż zasób playlistItem, więc możesz wybrać metodę, która najlepiej odpowiada Twoim potrzebom.