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 и ответ.