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

В следующих примерах показано, как использовать 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 , вы можете выбрать метод, который лучше всего соответствует вашим потребностям.