LiveChatModerators
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
liveChatModerator
資源代表 YouTube 直播聊天室的管理員。聊天室管理員可以封鎖或解除使用者的聊天室權限、移除訊息,以及執行其他直播聊天室管理動作。
方法
這個 API 支援 liveChatModerators
資源的下列方法。所有要求都必須由直播聊天頻道的擁有者授權。
- list
- 列出聊天室管理員。立即試用。
- 插入
- 為聊天室新增管理員。立即試用。
- 刪除
- 移除即時通訊管理員。立即試用。
屬性
下表定義了這個資源中顯示的屬性:
屬性 |
kind |
string
識別 API 資源的類型。值為 youtube#liveChatModerator 。 |
etag |
etag
這項資源的 Etag。 |
id |
string
YouTube 指派的 ID,用於識別管理員。 |
snippet |
object
snippet 物件包含管理員的詳細資料。 |
snippet.moderatorDetails |
object
這個物件包含版主相關詳細資料。 |
snippet.moderatorDetails.channelId |
string
審核人員的 YouTube 頻道 ID。 |
snippet.moderatorDetails.channelUrl |
string
版主 YouTube 頻道的網址。 |
snippet.moderatorDetails.displayName |
string
版主 YouTube 頻道的顯示名稱。 |
snippet.moderatorDetails.profileImageUrl |
string
版主 YouTube 頻道的顯示圖片網址。 |
snippet.liveChatId |
string
管理員有權管理的聊天室 ID。與廣播活動相關聯的即時通訊 ID 會在 liveBroadcast 資源的 snippet.liveChatId 屬性中傳回。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-06-19 (世界標準時間)。
[null,null,["上次更新時間:2025-06-19 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eliveChatModerator\u003c/code\u003e resources represent individuals with the authority to manage a YouTube live chat, including banning/unbanning users and removing messages.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods to list, add, and delete moderators for a live chat, requiring authorization from the live chat's channel owner.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eliveChatModerator\u003c/code\u003e resource includes properties like \u003ccode\u003emoderatorDetails\u003c/code\u003e, \u003ccode\u003eliveChatId\u003c/code\u003e, \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, and \u003ccode\u003eid\u003c/code\u003e, providing comprehensive information about each moderator.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003emoderatorDetails\u003c/code\u003e section of the resource provides specific information about the moderator, such as their channel ID, URL, display name, and profile image URL.\u003c/p\u003e\n"]]],["`liveChatModerator` resources manage YouTube live chat moderators. Moderators can ban/unban users and remove messages. The API methods include: `list` to view moderators, `insert` to add new ones, and `delete` to remove them. Each moderator resource contains properties like `kind`, `etag`, and `id`, alongside `snippet` details such as `moderatorDetails` (including `channelId`, `channelUrl`, `displayName`, and `profileImageUrl`) and the associated `liveChatId`. All requests require authorization from the live chat's channel owner.\n"],null,["# LiveChatModerators\n\nA **liveChatModerator** resource represents a moderator for a YouTube live chat. A chat moderator has the ability to ban or unban users from a chat, remove messages, and perform other administrative actions for the live chat.\n\nMethods\n-------\n\nThe API supports the following methods for `liveChatModerators` resources. All of the requests must be authorized by the owner of the live chat's channel.\n\n[list](/youtube/v3/live/docs/liveChatModerators/list)\n: Lists moderators for a live chat.\n [Try it now](/youtube/v3/live/docs/liveChatModerators/list#try-it).\n\n[insert](/youtube/v3/live/docs/liveChatModerators/insert)\n: Adds a new moderator for the chat.\n [Try it now](/youtube/v3/live/docs/liveChatModerators/insert#try-it).\n\n[delete](/youtube/v3/live/docs/liveChatModerators/delete)\n: Removes a chat moderator.\n [Try it now](/youtube/v3/live/docs/liveChatModerators/delete#try-it).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `liveChatModerators` resource: \n\n```text\n{\n \"kind\": \"youtube#liveChatModerator\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"moderatorDetails\": {\n \"channelId\": string,\n \"channelUrl\": string,\n \"displayName\": string,\n \"profileImageUrl\": string\n },\n \"liveChatId\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#liveChatModerator`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the moderator. |\n| `snippet` | `object` The `snippet` object contains details about the moderator. |\n| snippet.`moderatorDetails` | `object` This object contains details about the moderator. |\n| snippet.moderatorDetails.`channelId` | `string` The moderator's YouTube channel ID. |\n| snippet.moderatorDetails.`channelUrl` | `string` The URL of the moderator's YouTube channel. |\n| snippet.moderatorDetails.`displayName` | `string` The display name of the moderator's YouTube channel. |\n| snippet.moderatorDetails.`profileImageUrl` | `string` The avatar URL of the moderator's YouTube channel. |\n| snippet.`liveChatId` | `string` The ID of the live chat that the moderator has privileges to administer. The live chat ID associated with a broadcast is returned in the `liveBroadcast` resource's `snippet.liveChatId` property. |"]]