В следующих примерах показано, как использовать API данных YouTube (v3) для выполнения функций, связанных с оценками видео.
Оценить видео
Вызовите метод videos.rate
, чтобы отправить оценку пользователя для видео. Этот запрос должен быть авторизован с использованием OAuth 2.0.
Установите следующие два параметра в запросе:
- Параметр
id
указывает идентификатор видео на YouTube для видео, которое оценивается (или рейтинг которого удаляется). - Параметр
rating
указывает рейтинг, который пользователь, авторизующий запрос, желает записать. Допустимые значения параметров:like
,dislike
иnone
. Первые два значения устанавливают оценку, а третье удаляет любую оценку, которая ранее существовала для пользователя.
Приведенный ниже пример запроса дает положительную оценку (лайк) видео основного выступления на конференции Google I/O 2014 года:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
Получить текущую пользовательскую оценку видео
Метод videos.getRating
позволяет получить текущий рейтинг пользователя, прошедшего проверку подлинности, для одного или нескольких видео. В своем запросе установите значение параметра id
в список разделенных запятыми идентификаторов видео YouTube для ресурсов, для которых вы получаете данные рейтинга. Обратите внимание, что этот запрос должен быть авторизован с использованием OAuth 2.0.
Приведенный ниже пример запроса извлекает текущую пользовательскую оценку видео с основным докладом на конференции Google I/O 2014 года. (Если вы выполнили предыдущий пример в обозревателе API, в ответе API должно быть указано, что рейтинг like
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
Получить видео, оцененные текущим пользователем
Параметр myRating
метода videos.list
позволяет получить список видео, оцененных пользователем, авторизовавшим запрос API. Значение параметра указывает, хотите ли вы получить понравившиеся или не понравившиеся видео.
Приведенный ниже пример запроса извлекает список видео, которым текущий пользователь поставил оценку like
. Запрос должен быть авторизован с использованием OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
contentDetails.relatedPlaylists.likes
содержит значение.Таким образом, API позволяет получить список видео, которые понравились пользователю, используя либо метод
videos.list
, либо метод playlistItems.list
. Поскольку в video
возвращается другая информация, чем в ресурсе playlistItem
, вы можете выбрать метод, который лучше всего соответствует вашим потребностям.