يؤدي هذا الإجراء إلى تغيير حالة رسالة في المحادثة المباشرة على YouTube ويبدأ أي عمليات مرتبطة بالحالة الجديدة. على سبيل المثال، عندما تغيّر حالة استطلاع مباشر إلى closed، ينهي YouTube استطلاع هذه الرسالة. قبل طلب هذه الطريقة، عليك التأكّد من أنّ قيمة السمة status لرسالة الاستطلاع المباشر هي active.
تأثير الحصة: يؤدي طلب هذه الطريقة إلى استهلاك 20 وحدة من الحصة.
طلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages/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 للحصول على نتيجة الاستطلاع النهائية في نص الاستجابة.
|
|
نص الطلب
لا تُدرِج نص طلب عند طلب هذه الطريقة.
الردّ
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مصدر liveChatMessages في نص الاستجابة.
الأخطاء
يعرض الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسائل الخطأ لمزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
forbidden (403) |
forbidden |
ليس لديك الأذونات المطلوبة لتغيير حالة الرسالة المحدّدة. |
required (400) |
idRequired |
يجب أن تحدّد المَعلمة المطلوبة id الرسالة التي تريد تغيير حالتها. |
required (400) |
statusRequired |
يجب أن يحدّد طلب بيانات من واجهة برمجة التطبيقات قيمة للمَعلمة status. |
notFound (404) |
liveChatMessagesNotFound |
الرسالة المحدّدة من خلال المَعلمة id غير متوفّرة. |
forbidden (403) |
modificationNotAllowed |
لا يمكن تغيير حالة مصدر liveChatMessage المحدّد. قد تحدّد المَعلمة id رسالة لا يمكن تغيير حالتها. |
جرِّبها الآن.
استخدِم APIs Explorer لطلب واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والاستجابة.