Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
Implementacja: oceny
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-11-23 UTC.
[null,null,["Ostatnia aktualizacja: 2024-11-23 UTC."],[[["\u003cp\u003eThe YouTube Data API (v3) allows users to rate videos using the \u003ccode\u003evideos.rate\u003c/code\u003e method, with options to \u003ccode\u003elike\u003c/code\u003e, \u003ccode\u003edislike\u003c/code\u003e, or remove a rating (\u003ccode\u003enone\u003c/code\u003e), requiring OAuth 2.0 authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the currently authenticated user's rating for specific videos by using the \u003ccode\u003evideos.getRating\u003c/code\u003e method and providing a comma-separated list of video IDs, also requiring OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the \u003ccode\u003evideos.list\u003c/code\u003e method and its \u003ccode\u003emyRating\u003c/code\u003e parameter, which also requires OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, users can retrieve a list of their liked videos by using the \u003ccode\u003eplaylistItems.list\u003c/code\u003e method and accessing the \u003ccode\u003econtentDetails.relatedPlaylists.likes\u003c/code\u003e property, which offers an alternative to the \u003ccode\u003evideos.list\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"],null,["# Implementation: Ratings\n\nThe following examples show how to use the YouTube Data API (v3) to perform functions related to video ratings.\n\nRate a video\n------------\n\nCall the [videos.rate](/youtube/v3/docs/videos/rate) method to submit a user's rating for a video. This request must be authorized using OAuth 2.0.\n\nSet the following two parameters in your request:\n\n\u003cbr /\u003e\n\n- The [id](/youtube/v3/docs/videos/rate#id) parameter specifies the YouTube video ID of the video that is being rated (or having its rating removed).\n- The [rating](/youtube/v3/docs/videos/rate#rating) parameter specifies the rating that the user authorizing the request wishes to record. Valid parameter values are `like`, `dislike`, and `none`. The first two values set a rating, and the third removes any rating that previously existed for the user.\n\n\u003cbr /\u003e\n\nThe sample request below gives a positive (like) rating to the video of the keynote speech at the 2014 Google I/O conference: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?\n id=wtLJPvx7-ys\n &rating=like\n```\n\nRetrieve the current user's rating of a video\n---------------------------------------------\n\nThe [videos.getRating](/youtube/v3/docs/videos/getRating) method lets you retrieve the currently authenticated user's rating of one or more videos. In your request, set the [id](/youtube/v3/docs/videos/rate#id) parameter's value to a comma-separated list of YouTube video IDs for the resources for which you are retrieving rating data. Note that this request must be authorized using OAuth 2.0.\n\nThe sample request below retrieves the current user's rating of the video of the keynote speech at the 2014 Google I/O conference. (If you executed the previous example in the APIs Explorer, the API response should indicate that the rating is `like`. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?\nid=wtLJPvx7-ys\n```\n\nRetrieve videos rated by the current user\n-----------------------------------------\n\nThe `videos.list` method's [myRating](/youtube/v3/docs/videos/list#myRating) parameter lets you retrieve a list of videos rated by the user authorizing the API request. The parameter value indicates whether you want to retrieve liked or disliked videos.\n\nThe sample request below retrieves a list of videos to which the current user gave a `like` rating. The request must be authorized using OAuth 2.0. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?\npart=snippet\n&myRating=like\n``` \n**Note:** You can also retrieve a list of the user's liked videos (but not disliked videos) by following the flow for [retrieving a channel's favorite videos](#favorites). In step 1 of that process, instead of retrieving the playlist ID for the channel's favorite videos, retrieve the playlist ID for the channel's liked videos. The `contentDetails.relatedPlaylists.likes` property contains the value. \n\nThus, the API allows you to retrieve a list of videos that the user liked using either the `videos.list` method or the `playlistItems.list` method. Since different information is returned in a `video` resource than a `playlistItem` resource, you can choose the method that best suits your needs."]]
