Videos: getRating

Получает оценки, которые авторизованный пользователь поставил указанным видео.

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

Примеры использования

Запрос

HTTP-запрос

GET https://www.googleapis.com/youtube/v3/videos/getRating

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей доступа. Подробнее…

Область действия
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id определяет список идентификаторов видео YouTube, разделенных запятыми, для ресурсов, для которых вы получаете данные о рейтинге. В ресурсе video свойство id указывает на идентификатор видео.
Необязательные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в авторизованном запросе. Примечание. Этот параметр предназначен исключительно для партнеров YouTube.

Параметр onBehalfOfContentOwner указывает, что учетные данные, которые используются для авторизации запроса, идентифицируют пользователя системы управления контентом YouTube, действующего от имени владельца контента, указанного в значении параметра. Этот параметр предназначен для партнеров YouTube, которые владеют несколькими каналами и управляют ими. Владельцы контента могут пройти аутентификацию один раз и получить доступ к данным всех своих видео и каналов. Аккаунт CMS, с помощью которого пользователь проходит аутентификацию, должен быть связан с указанным владельцем контента YouTube.

Тело запроса

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

Ответ

В случае успеха метод возвращает тело ответа со следующей структурой:

{
  "kind": "youtube#videoGetRatingResponse",
  "etag": etag,
  "items": [
    {
      "videoId": string,
      "rating": string
    }
  ]
}

Свойства

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

Свойства
kind string
Определяет тип ресурса API. Значение будет youtube#videoGetRatingResponse.
etag etag
Тег Etag этого ресурса.
items[] list
Список рейтингов, соответствующих критериям запроса.
items[].videoId string
Идентификатор, который YouTube использует для уникальной идентификации видео.
items[].rating string
Оценка, которую авторизованный пользователь поставил видео.

Допустимые значения этого свойства:
  • dislike
  • like
  • none
  • unspecified

Ошибки

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

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.