LiveChatBans

Ресурс liveChatBan идентифицирует пользователя YouTube и чат, в котором он заблокирован.

Методы

API поддерживает следующие методы для ресурсов liveChatBans:

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

Представление ресурса

Ниже показана структура JSON для ресурса liveChatBans.

{
  "kind": "youtube#liveChatBan",
  "etag": etag,
  "id": string,
  "snippet": {
    "liveChatId": string,
    "type": string,
    "banDurationSeconds": unsigned long,
    "bannedUserDetails": {
      "channelId": string
    }
  }
}

Свойства

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

Свойства
kind string
Определяет тип ресурса API. Значение будет youtube#liveChatBan.
etag etag
Тег Etag этого ресурса.
id string
Идентификатор, который YouTube присваивает для уникальной идентификации блокировки.
snippet object
Объект snippet идентифицирует заблокированного пользователя и содержит информацию о блокировке.
snippet.liveChatId string
Чат, к которому относится блокировка. Идентификатор чата, связанного с трансляцией, возвращается в свойстве snippet.liveChatId ресурса liveBroadcast.
snippet.type string
Тип блокировки.

Допустимые значения для этого свойства:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Продолжительность блокировки. Указывайте значение этого свойства, только если тип блокировки – temporary. Значение по умолчанию – 300 (5 минут).
snippet.bannedUserDetails object
Этот объект содержит информацию, которая идентифицирует заблокированного пользователя.
snippet.bannedUserDetails.channelId string
Идентификатор канала YouTube заблокированного пользователя.