Реализация: Рейтинги

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

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