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。