LiveChatModerators
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
liveChatModerator
リソースは、YouTube ライブチャットのモデレーターを表します。チャット モデレーターは、チャットからユーザーをブロックまたはブロック解除したり、メッセージを削除したり、チャット サポートの管理操作を行ったりできます。
メソッド
この API は、liveChatModerators
リソースの次のメソッドをサポートしています。すべてのリクエストは、チャット チャンネルの所有者によって承認されている必要があります。
- list
- チャットのモデレーターを一覧表示します。今すぐ試す
- insert
- チャットに新しいモデレーターを追加します。今すぐ試す
- delete
- チャット モデレーターを削除します。今すぐ試す
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ |
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 チャンネルの URL。 |
snippet.moderatorDetails.displayName |
string
モデレーターの YouTube チャンネルの表示名。 |
snippet.moderatorDetails.profileImageUrl |
string
モデレーターの YouTube チャンネルのアバター URL。 |
snippet.liveChatId |
string
モデレーターが管理する権限を持つチャットの ID。ブロードキャストに対応するチャット ID は、liveBroadcast リソースの snippet.liveChatId プロパティで返されます。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-06-19 UTC。
[null,null,["最終更新日 2025-06-19 UTC。"],[[["\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. |"]]