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。