Videos: reportAbuse

Сообщает о видео, содержащем оскорбительный контент.

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

Запрос

HTTP-запрос 

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

Авторизация

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

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

Параметры

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

Параметры
Дополнительные параметры
onBehalfOfContentOwner string
Этот параметр можно использовать только в должным образом авторизованном запросе . Примечание. Этот параметр предназначен исключительно для контент-партнеров YouTube.

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

Тело запроса

Тело запроса имеет следующую структуру данных:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

Обязательные свойства

Необходимо установить значения для следующих свойств:

Дополнительные свойства

Вы можете установить значения для следующих свойств:

Характеристики

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

Характеристики
videoId string
Идентифицирует видео, на которое поступила жалоба, поскольку оно содержит оскорбительный контент. Установите значение идентификатора видео YouTube для этого видео.
reasonId object
Указывает причину того, что видео, на которое поступила жалоба, содержит оскорбительный контент. Установите значение unique ID соответствующего ресурса videoAbuseReportReason .
secondaryReasonId object
Указывает дополнительную причину, по которой видео, о котором сообщается, содержит оскорбительный контент. Вторичная причина предоставляет более конкретное описание нежелательного содержимого, чем основная причина, которую определяет свойство reasonId . Установите в качестве значения unique ID соответствующей вторичной причины.
comments string
Предоставляет любую дополнительную информацию, которую хочет добавить репортер.
language object
Определяет язык, на котором говорит репортер.

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
badRequest (400) invalidAbuseReason Запрос содержал неожиданное значение свойства reasonId или недопустимую комбинацию свойств reasonId и secondaryReasonId .
badRequest (400) rateLimitExceeded Пользователь отправил слишком много запросов за определенный период времени.
forbidden (403) forbidden
notFound (404) videoNotFound Видео, о нарушении которого вы пытаетесь сообщить, не найдено.

Попробуйте!

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