LiveChatBans

liveChatBan 资源用于标识被禁止参与的 YouTube 用户和 YouTube 实时聊天。

该 API 支持 liveChatBans 资源的以下方法:

插入
禁止特定用户参与实时聊天。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 分配的 ID,用于明确标识此禁令。
snippet object
snippet 对象会禁止用户,并包含有关禁止的详细信息。
snippet.liveChatId string
该禁令适用的实时聊天。与广播关联的实时聊天 ID 会在 liveBroadcast 资源的 snippet.liveChatId 属性中返回。
snippet.type string
禁止类型。

此属性的有效值包括:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
此禁令的持续时间。仅当禁止类型为 temporary 时,才为此属性设置值。默认值为 300(5 分钟)。
snippet.bannedUserDetails object
此对象包含用于识别被禁用户的信息。
snippet.bannedUserDetails.channelId string
被禁用户的 YouTube 频道 ID。