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