LiveChatMessages: transition
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينقل هذا الحدث حالة رسالة المحادثة المباشرة في YouTube ويبدأ أي عمليات مرتبطة بالحالة الجديدة. على سبيل المثال، عند تغيير حالة استطلاع مباشر إلى closed، تُنهي YouTube استطلاع الرأي المعنيّ. قبل استخدام هذه الطريقة، يجب التأكّد من أنّ قيمة السمة status لرسالة الاستطلاع المباشر هي active.
الطلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلمات
يسرد الجدول التالي المَعلمات التي يتيحها هذا طلب البحث. وجميع المَعلمات المُدرجة هي مَعلمات طلب بحث.
| المعلمات |
| المَعلمات المطلوبة |
id |
string
تحدد المعلمة id المعرف الفريد للرسالة التي تنتقل إلى حالة أخرى. |
status |
enum
تحدِّد المَعلمة status الحالة التي يتم تغيير الرسالة إليها. لنقل رسالة إلى الحالة closed، يجب ضبط السمة status على active للاستطلاع المرتبط بالرسالة.
يمكنك فقط الانتقال إلى closed، مما يعني أن الاستطلاع مغلق.
|
| المَعلمات الاختيارية |
part |
string
تحدّد المعلمة part أجزاء موارد liveChatMessage التي ستتضمّنها استجابة واجهة برمجة التطبيقات. والقيم المسموح بإدراجها هي id وsnippet وauthorDetails.
يمكنك ضبط قيمة المَعلمة على snippet للحصول على نتيجة الاستطلاع النهائية في نص الاستجابة.
|
نص الطلب
لا تقدِّم نص طلب عند استدعاء هذه الطريقة.
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب موجّه إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ لمعرفة المزيد من التفاصيل.
| نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
forbidden |
ليس لديك الأذونات المطلوبة لنقل حالة الرسالة المحددة. |
required (400) |
idRequired |
يجب أن تحدد معلمة id المطلوبة الرسالة التي تريد نقل حالتها. |
required (400) |
statusRequired |
يجب أن يحدّد طلب البيانات من واجهة برمجة التطبيقات قيمة للمَعلمة status. |
notFound (404) |
liveChatMessagesNotFound |
الرسالة التي حدّدتها المَعلمة id غير موجودة. |
forbidden (403) |
modificationNotAllowed |
لا يمكن نقل حالة مورد liveChatMessage المحدّد. قد تحدد المعلمة id رسالة لا يمكن نقل حالتها. |
جرّب الآن
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API endpoint transitions the status of a YouTube live chat message, such as closing an active poll.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization and must include the message's unique \u003ccode\u003eid\u003c/code\u003e and the new \u003ccode\u003estatus\u003c/code\u003e (\u003ccode\u003eclosed\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter, which is optional, specifies which parts of the \u003ccode\u003eliveChatMessage\u003c/code\u003e resource to include in the API response (e.g. \u003ccode\u003esnippet\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003eauthorDetails\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eSuccessful calls to this API will return a \u003ccode\u003eliveChatMessages\u003c/code\u003e resource in the response body, detailing the message's new status.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors include \u003ccode\u003eforbidden\u003c/code\u003e for permission issues, \u003ccode\u003erequired\u003c/code\u003e for missing parameters, \u003ccode\u003enotFound\u003c/code\u003e if the message ID doesn't exist, and \u003ccode\u003emodificationNotAllowed\u003c/code\u003e if the specified message's status can't be changed.\u003c/p\u003e\n"]]],["This API endpoint, `liveChatMessages/transition`, changes a YouTube live chat message's status and triggers related actions. It requires the message's `id` and the target `status`, which can only be `closed`. The `status` of the poll must be `active` to proceed with the transition. The request is a `POST` method without a request body. Authorization scopes `youtube` or `youtube.force-ssl` are needed. Upon success, a `liveChatMessages` resource is returned, and errors include `forbidden`, `required`, and `notFound`.\n"],null,[]]
