Videos: rate

Добавьте к видео оценку «нравится» или «не нравится» или удалите оценку из видео.

Влияние квоты. Стоимость вызова этого метода составляет 50 единиц.

ПРИМЕЧАНИЕ. Это не влияет на официальное количество лайков/дизлайков видео.

Распространенные случаи использования

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/videos/rate

Авторизация

Этот запрос требует авторизации хотя бы с одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
id string
Параметр id указывает идентификатор видео YouTube, которому присваивается рейтинг или рейтинг которого удаляется.
rating string
Указывает рейтинг для записи.

Приемлемые значения:
  • dislike — записывает, что аутентифицированному пользователю видео не понравилось.
  • like — записывает, что видео понравилось авторизованному пользователю.
  • none — удаляет все оценки, которые ранее установил для видео аутентифицированный пользователь.

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

В случае успеха этот метод возвращает код ответа HTTP 204 ( No Content ).

Ошибки

В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .

Тип ошибки Детализация ошибки Описание
badRequest (400) emailNotVerified Прежде чем поставить оценку, пользователь должен подтвердить свой адрес электронной почты.
badRequest (400) invalidRating Запрос содержал неожиданное значение параметра rating .
badRequest (400) videoPurchaseRequired Прокатным видео могут оценивать только пользователи, которые взяли их напрокат.
forbidden (403) forbidden Видео, которому вы пытаетесь оценить, не может быть оценено. Возможно, запрос не авторизован должным образом.
forbidden (403) videoRatingDisabled Владелец видео, которому вы пытаетесь оценить, отключил оценку этого видео.
notFound (404) videoNotFound Видео, которому вы пытаетесь оценить, не найдено. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

Попробуй это!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.

,

Добавьте к видео оценку «нравится» или «не нравится» или удалите оценку из видео.

Влияние квоты. Стоимость вызова этого метода составляет 50 единиц.

ПРИМЕЧАНИЕ. Это не влияет на официальное количество лайков/дизлайков видео.

Распространенные случаи использования

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/videos/rate

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
id string
Параметр id указывает идентификатор видео YouTube, которому присваивается рейтинг или рейтинг которого удаляется.
rating string
Указывает рейтинг для записи.

Приемлемые значения:
  • dislike — записывает, что аутентифицированному пользователю видео не понравилось.
  • like — записывает, что видео понравилось авторизованному пользователю.
  • none — удаляет все оценки, которые ранее установил для видео аутентифицированный пользователь.

Тело запроса

Не указывайте тело запроса при вызове этого метода.

Ответ

В случае успеха этот метод возвращает код ответа HTTP 204 ( No Content ).

Ошибки

В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .

Тип ошибки Детализация ошибки Описание
badRequest (400) emailNotVerified Прежде чем поставить оценку, пользователь должен подтвердить свой адрес электронной почты.
badRequest (400) invalidRating Запрос содержал неожиданное значение параметра rating .
badRequest (400) videoPurchaseRequired Прокатным видео могут оценивать только пользователи, которые взяли их напрокат.
forbidden (403) forbidden Видео, которому вы пытаетесь оценить, не может быть оценено. Возможно, запрос не авторизован должным образом.
forbidden (403) videoRatingDisabled Владелец видео, которому вы пытаетесь оценить, отключил оценку этого видео.
notFound (404) videoNotFound Видео, которому вы пытаетесь оценить, не найдено. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

Попробуй это!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.