Ресурс liveChatBan идентифицирует пользователя YouTube и чат 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 | etagEtag этого ресурса. |
id | stringИдентификатор, который YouTube назначает для уникальной идентификации запрета. |
snippet | objectОбъект snippet идентифицирует забаненного пользователя и содержит сведения о бане. |
snippet. liveChatId | stringОнлайн-чат, к которому применяется запрет. Идентификатор онлайн-чата, связанный с трансляцией, возвращается в свойстве snippet.liveChatId ресурса liveBroadcast . |
snippet. type | stringТип запрета. Допустимые значения для этого свойства:
|
snippet. banDurationSeconds | unsigned longДлительность бана. Задавайте значение этого свойства только если тип бана temporary . Значение по умолчанию — 300 (5 минут). |
snippet. bannedUserDetails | objectЭтот объект содержит информацию, идентифицирующую заблокированного пользователя. |
snippet.bannedUserDetails. channelId | stringИдентификатор канала заблокированного пользователя YouTube. |