LiveChatBans: insert

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

Распространенные случаи использования

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/liveChat/bans

Авторизация

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

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

Параметры

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

Параметры
Обязательные параметры
part string
Параметр part в этой операции служит двум целям. Он определяет свойства, которые будут установлены операцией записи, а также свойства, которые возвращает ответ API. Установите значение параметра snippet .

Тело запроса

Укажите ресурс liveChatBan в теле запроса. Для этого ресурса:

  • Вы должны указать значение для этих свойств:

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

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

    • snippet.banDurationSeconds

Ответ

В случае успеха этот метод возвращает ресурс liveChatBan в теле ответа.

Ошибки

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

Тип ошибки Детализация ошибки Описание
forbidden (403) insufficientPermissions У вас нет необходимых разрешений, чтобы заблокировать пользователя в указанном чате.
forbidden (403) liveChatBanInsertionNotAllowed Указанный бан не может быть создан. Эта ошибка может возникнуть, если запрос пытается заблокировать владельца чата или другого модератора.
invalidValue (400) invalidChannelId Указанный идентификатор канала не найден.
invalidValue (400) invalidLiveChatId Значение snippet.liveChatId указанное в запросе, недействительно. Проверьте связанный ресурс liveBroadcast и убедитесь, что вы указали правильное значение.
notFound (404) liveChatNotFound Указанный чат не найден. Проверьте связанный ресурс liveBroadcast и убедитесь, что для свойства snippet.liveChatId установлено правильное значение.
notFound (404) liveChatUserNotFound Пользователь чата, которого вы пытаетесь заблокировать, не найден.
required (400) bannedUserChannelIdRequired Ресурс liveChatBan , отправленный в тексте запроса, должен указать значение свойства snippet.bannedUserDetails.channelId .
required (400) liveChatIdRequired Ресурс liveChatBan , отправленный в теле запроса, должен указать значение свойства snippet.liveChatId .

Попробуй это!

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