LiveChatModerators
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمثّل المورد liveChatModerator
مشرفًا في محادثة مباشرة على YouTube. يمكن للمشرف في المحادثة حظر المستخدمين من المحادثة أو إزالة حظرهم، وإزالة الرسائل، وتنفيذ إجراءات إدارية أخرى في المحادثة المباشرة.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد liveChatModerators
. يجب أن يوافق مالك القناة على جميع الطلبات.
- list
- تُدرج المشرفين على المحادثة المباشرة.
التجربة الآن
- إدراج
- تُضيف مشرفًا جديدًا إلى المحادثة.
التجربة الآن
- حذف
- تؤدي هذه الخطوة إلى إزالة مشرف محادثة.
التجربة الآن
الخصائص
يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:
الخصائص |
kind |
string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#liveChatModerator . |
etag |
etag
رقم تعريف Etag لهذا المرجع. |
id |
string
المعرّف الذي تحدّده YouTube لتحديد المشرف بشكل فريد |
snippet |
object
يحتوي العنصر snippet على تفاصيل عن المشرف. |
snippet.moderatorDetails |
object
يحتوي هذا العنصر على تفاصيل عن المشرف. |
snippet.moderatorDetails.channelId |
string
معرّف قناة المشرف على YouTube. |
snippet.moderatorDetails.channelUrl |
string
عنوان URL الخاص بقناة المشرف على YouTube. |
snippet.moderatorDetails.displayName |
string
الاسم المعروض لقناة المشرف على YouTube. |
snippet.moderatorDetails.profileImageUrl |
string
عنوان URL الخاص بالأفاتار في قناة المشرف على YouTube. |
snippet.liveChatId |
string
رقم تعريف المحادثة المباشرة التي يملك المشرف امتيازات إدارتها. يتم عرض معرّف المحادثة المباشرة المرتبط بالبث في سمة snippet.liveChatId لمصدر liveBroadcast . |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]