Реализация: оценки

Ниже приведены примеры того, как с помощью YouTube Data API (версия 3) выполнять действия, связанные с оценками видео.

Оценить видео

Вызовите метод 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 Explorer, ответ 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
Примечание. Вы также можете получить список понравившихся пользователю видео (но не тех, которые он отметил как не понравившиеся), выполнив инструкции по получению списка любимых видео канала. На шаге 1 вместо идентификатора плейлиста с любимыми видео канала получите идентификатор плейлиста с понравившимися видео. Значение содержится в свойстве contentDetails.relatedPlaylists.likes.

Таким образом, API позволяет получить список видео, которые понравились пользователю, с помощью метода videos.list или playlistItems.list. Поскольку ресурсы video и playlistItem возвращают разные данные, вы можете выбрать наиболее подходящий для вас метод.