إضافة رسالة إلى محادثة مباشرة تتيح واجهة برمجة التطبيقات حاليًا إمكانية إدراج رسائل نصية فقط.
حالات الاستخدام الشائعة
الطلب
طلب HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).
النطاق |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المَعلمات
يسرد الجدول التالي المعلَمات التي يتيحها طلب البحث هذا. كلّ المَعلمات المدرَجة هي مَعلمات طلب بحث.
المَعلمات | ||
---|---|---|
المَعلمات المطلوبة | ||
part |
string تُستخدم المَعلمة part غرضان. وتحدِّد هذه السياسة الخصائص التي ستضبطها عملية الكتابة بالإضافة إلى الخصائص التي ستتضمّنها استجابة واجهة برمجة التطبيقات. اضبط قيمة المعلَمة على snippet . |
نص الطلب
قدِّم مورد LiveChatMessage في نص الطلب. بالنسبة لهذا المورد:
-
يجب تحديد قيمة لهذه السمات:
snippet.liveChatId
snippet.type
: القيمة الوحيدة المسموح بها في الوقت الحالي هيtextMessageEvent
.snippet.textMessageDetails.messageText
الإجابة
في حال نجاحها، تعرض هذه الطريقة مورد LiveChatMessage في نص الاستجابة.
الأخطاء
يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
forbidden |
ليس لديك الأذونات المطلوبة لإنشاء الرسالة المحددة. |
forbidden (403) |
liveChatDisabled |
أوقَف المالك المحادثة المباشرة، ما يعني أنّه لا يمكن إضافة رسائل إلى المحادثة. |
forbidden (403) |
liveChatEnded |
المحادثة المباشرة المحدّدة لم تعُد منشورة. |
invalidValue (400) |
messageTextInvalid |
نص الرسالة (snippet.textMessageDetails.messageText ) غير صالح. |
notFound (404) |
liveChatNotFound |
المحادثة المباشرة المحدَّدة في طلب البيانات من واجهة برمجة التطبيقات غير متوفّرة. يحدث هذا الخطأ إذا حذف المالك المحادثة. |
rateLimitExceeded |
rateLimitExceeded |
نشر المستخدم عددًا كبيرًا جدًا من رسائل المحادثة في إطار زمني معيَّن. |
required (400) |
liveChatIdRequired |
يجب أن يتضمّن مورد LiveChatMessage قيمة للسمة snippet.liveChatId وأن يحدّدها. |
required (400) |
messageTextRequired |
يجب أن يتضمّن مورد LiveChatMessage قيمة للسمة snippet.textMessageDetails.messageText وأن يحدّدها. |
required (400) |
typeRequired |
يجب أن يتضمّن مورد LiveChatMessage قيمة للسمة snippet.type وأن يحدّدها. ضبط قيمة المعلَمة على text |
تجربة
يمكنك استخدام APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.