Сообщает о видео, содержащем оскорбительный контент.
Влияние квоты: вызов этого метода имеет стоимость квоты 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.