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