LiveChatMessages: insert
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تضيف رسالة أو استطلاعًا إلى محادثة مباشرة.
حالات الاستخدام الشائعة
الطلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
التفويض
يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية. للاطّلاع على مزيد من المعلومات عن المصادقة والتفويض، يُرجى الاطّلاع على مقالة تنفيذ مصادقة OAuth 2.0.
| النطاق |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يعرض الجدول التالي المَعلمات التي يتيح طلب البحث استخدامها. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.
| المعلمات |
| المَعلمات المطلوبة |
part |
string
تخدم المَعلمة part غرضَين. ويحدِّد السمات التي ستضبطها عملية الكتابة بالإضافة إلى السمات التي ستتضمّنها استجابة واجهة برمجة التطبيقات. اضبط قيمة المَعلمة على snippet. |
نص الطلب
قدِّم مورد liveChatMessage في نص الطلب.
بالنسبة إلى هذا المرجع، يجب تحديد قيم لهذه السمات.
snippet.liveChatIdsnippet.type - اختَر أحد الخيارَين التاليَين: textMessageEvent أو pollEvent- إذا كان النوع هو
textMessageEvent، يجب تضمين snippet.textMessageDetails.messageText.
- إذا كان النوع هو
pollEvent، أدرِج snippet.pollDetails بالقيم التالية:
snippet.pollDetails.metadata.options.questionText- قائمة
snippet.pollDetails.metadata.options.optionText يجب إدراج عنصرَين على الأقل ولا يزيد عن خمسة عناصر. يتم عرض العناصر تسلسليًا بالترتيب الذي تم إدراجها به.
الأخطاء
يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Live Streaming API - Errors.
| نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
forbidden |
لا تملك الأذونات المطلوبة لإنشاء الرسالة المحدّدة. |
forbidden (403) |
liveChatDisabled |
أوقف المالك المحادثة المباشرة المحدّدة، ما يعني أنّه لا يمكن إضافة رسائل إلى المحادثة. |
forbidden (403) |
liveChatEnded |
لم تعُد المحادثة المباشرة المحدّدة متوفّرة. |
invalidValue (400) |
messageTextInvalid |
نص الرسالة (snippet.textMessageDetails.messageText) غير صالح. |
notFound (404) |
liveChatNotFound |
المحادثة المباشرة المحدّدة في طلب واجهة برمجة التطبيقات غير متوفّرة. يحدث هذا الخطأ إذا حذف المالك المحادثة. |
required (400) |
liveChatIdRequired |
يجب أن يتضمّن مورد liveChatMessage قيمة للسمة snippet.liveChatId ويحدّدها. |
required (400) |
messageTextRequired |
يجب أن يتضمّن مورد liveChatMessage قيمة للسمة snippet.textMessageDetails.messageText ويحدّدها. |
required (400) |
typeRequired |
يجب أن يتضمّن مورد liveChatMessage قيمة للسمة snippet.type ويحدّدها. اضبط قيمة المَعلمة على text. |
required (400) |
preconditionCheckFailed |
يتوفّر حاليًا استطلاع نشط تم تثبيته. |
rateLimitExceeded |
rateLimitExceeded |
نشر المستخدم عددًا كبيرًا جدًا من رسائل المحادثة في إطار زمني معيّن. |
جرّب الآن
استخدِم APIs Explorer للاتّصال بهذه الواجهة والاطّلاع على طلب البيانات والاستجابة من واجهة برمجة التطبيقات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-02 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# LiveChatMessages: insert\n\nAdds a message or a poll to a live chat.\n\nCommon use cases\n----------------\n\nThe list below shows common use cases for this method. Hover over a use case to see its description, or click on a use case to load sample parameter values in the APIs Explorer. You can open the [fullscreen APIs Explorer](#) to see code samples that dynamically update to reflect the parameter values entered in the Explorer.\n\nThe table below shows common use cases for this method. You can click on a use case name to load sample parameter values in the APIs Explorer. Or you can see code samples for a use case in the fullscreen APIs Explorer by clicking on the code icon below a use case name. In the fullscreen UI, you can update parameter and property values and the code samples will dynamically update to reflect the values you enter. \nThis method has one common use case, which is described below. The buttons below the description populate the APIs Explorer with sample values or open the fullscreen APIs Explorer to show code samples that use those values. The code samples also dynamically update if you change the values.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/v3/liveChat/messages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authentication](/youtube/v3/live/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to `snippet`. |\n\n### Request body\n\nProvide a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the request body.\nFor that resource, you must specify values for these properties\n\n- `snippet.liveChatId`\n- `snippet.type` - choose one of the following options: `textMessageEvent` or `pollEvent`\n- If type is `textMessageEvent`, include `snippet.textMessageDetails.messageText`\n- If type is `pollEvent`, include `snippet.pollDetails` with the following values:\n - `snippet.pollDetails.metadata.options.questionText`\n - List of `snippet.pollDetails.metadata.options.optionText`. You must list at least two items and no more than four items. Items are displayed sequentially in the order they're listed.\n\nResponse\n--------\n\nIf successful, this method returns a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Live Streaming API - Errors](/youtube/v3/live/docs/errors).\n\n| Error type | Error detail | Description |\n|----------------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `forbidden` | You don't have the permissions required to create the specified message. |\n| `forbidden (403)` | `liveChatDisabled` | The specified live chat has been disabled by the owner, which means messages cannot be added to the chat. |\n| `forbidden (403)` | `liveChatEnded` | The specified live chat is no longer live. |\n| `invalidValue (400)` | `messageTextInvalid` | The message text (`snippet.textMessageDetails.messageText`) is not valid. |\n| `notFound (404)` | `liveChatNotFound` | The live chat identified in the API request does not exist. This error occurs if the chat has been deleted by the owner. |\n| `required (400)` | `liveChatIdRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.liveChatId` property. |\n| `required (400)` | `messageTextRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.textMessageDetails.messageText` property. |\n| `required (400)` | `typeRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.type` property. Set the parameter value to `text` |\n| `required (400)` | `preconditionCheckFailed` | A pinned active poll already exists. |\n| `rateLimitExceeded` | `rateLimitExceeded` | The user has posted too many chat messages in a given timeframe. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
