本頁面由 Cloud Translation API 翻譯而成。

LiveChatBans

liveChatBan 資源可識別該使用者遭到禁止的 YouTube 使用者和 YouTube 聊天室。

方法

這個 API 支援下列 liveChatBans 資源的方法：

插入: 將特定使用者加入聊天室。API 要求必須由頻道擁有者或與停權相關的聊天室管理員授權。立即試用。
刪除: 移除禁止特定使用者參與聊天室的停權，讓使用者能重新加入即時通訊。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。