Implementacja: oceny

Przykłady poniżej pokazują, jak używać interfejsu YouTube Data API (v3) do wykonywania funkcji związanych z obeznaniami.

Oceń film wideo

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

W żądaniu ustaw te 2 parametry:

  • Parametr id określa identyfikator filmu w YouTube, który jest oceniany (lub którego ocena jest usuwana).
  • Parametr rating określa ocenę, którą użytkownik autoryzujący prośbę chce zapisać. Prawidłowe wartości parametrów to like, dislike i none. Pierwsze 2 wartości ustawiają ocenę, a trzecia usuwa ocenę, która istniała wcześniej dla tego użytkownika.

W przykładowym żądaniu poniżej film z przemówieniem na konferencji Google I/O w 2014 r. otrzymuje pozytywną ocenę (polubienie):

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

Pobieranie oceny filmu przez bieżącego użytkownika

Metoda videos.getRating umożliwia pobranie oceny co najmniej jednego filmu przez aktualnie uwierzytelnionego użytkownika. W żądaniu ustaw wartość parametru id jako listę rozdzielonych przecinkami identyfikatorów filmów w YouTube, których dane oceny chcesz pobrać. Pamiętaj, że to żądanie musi być autoryzowane za pomocą OAuth 2.0.

Przykładowa prośba poniżej pobiera ocenę bieżącego użytkownika filmu z przemówieniem na konferencji Google I/O w 2014 r. (jeśli w narzędziu APIs Explorer wykonasz poprzedni przykład, odpowiedź interfejsu API powinna wskazywać, że ocena to like).

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

Pobieranie filmów ocenionych przez bieżącego użytkownika

Parametr myRating metody videos.list umożliwia pobranie listy filmów ocenionych przez użytkownika, który autoryzował żądanie interfejsu API. Wartość parametru wskazuje, czy chcesz pobrać filmy z polubionymi lub odrzuconymi ocenami.

Przykładowe żądanie poniżej pobiera listę filmów, które bieżący użytkownik ocenił na like. Żądanie musi być autoryzowane za pomocą 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, które użytkownik polubił (ale nie tych, które dodał do listy „Nie podobają mi się”), korzystając z procedury pobierania ulubionych filmów z kanału. W kroku 1 tego procesu zamiast pobierać identyfikator playlisty z ulubionymi filmami na kanale, pobierz identyfikator playlisty z filmami, które zostały dodane do ulubionych. Właściwość contentDetails.relatedPlaylists.likes zawiera wartość

.Dzięki temu interfejs API umożliwia pobieranie listy filmów, które użytkownik polubił, za pomocą metody 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.