LiveChatMessages: insert

إضافة رسالة أو استطلاع إلى محادثة مباشرة

حالات الاستخدام الشائعة

الطلب

طلب 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 أو pollEvent.
  • إذا كان النوع textMessageEvent، يجب تضمين snippet.textMessageDetails.messageText.
  • إذا كان النوع pollEvent، أدرِج snippet.pollDetails مع القيم التالية:
    • snippet.pollDetails.metadata.options.questionText
    • قائمة snippet.pollDetails.metadata.options.optionText يجب إدراج عنصرين على الأقل وليس أكثر من خمسة عناصر. تظهر العناصر بشكل تسلسلي بالترتيب الذي تم إدراجها به.

الرد

في حال نجاح هذه الطريقة، سيتم عرض مصدر LiveChatMessage في نص الاستجابة.

الأخطاء

يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب موجّه إلى هذه الطريقة. يمكنك الاطّلاع على وثائق رسالة الخطأ لمعرفة المزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) forbidden ليس لديك الأذونات المطلوبة لإنشاء الرسالة المحددة.
forbidden (403) liveChatDisabled أوقف المالك المحادثة المباشرة المحدّدة، ما يعني أنّه لا يمكن إضافة الرسائل إلى المحادثة.
forbidden (403) liveChatEnded لم تعُد المحادثة المباشرة المحدّدة مباشرة.
invalidValue (400) messageTextInvalid نص الرسالة (snippet.textMessageDetails.messageText) غير صالح.
notFound (404) liveChatNotFound المحادثة المباشرة المحدّدة في طلب البيانات من واجهة برمجة التطبيقات غير متوفّرة. يحدث هذا الخطأ إذا حذف المالك المحادثة.
required (400) liveChatIdRequired يجب أن يتضمّن liveChatMessage resources قيمة للسمة snippet.liveChatId ويحدّدها.
required (400) messageTextRequired يجب أن يتضمّن liveChatMessage resources قيمة للسمة snippet.textMessageDetails.messageText ويحدّدها.
required (400) typeRequired يجب أن يتضمّن liveChatMessage resources قيمة للسمة snippet.type ويحدّدها. ضبط قيمة المَعلمة على text
required (400) preconditionCheckFailed هناك استطلاع نشط مثبَّت.
rateLimitExceeded rateLimitExceeded نشر المستخدم عددًا كبيرًا جدًا من رسائل المحادثة في إطار زمني معين.

جرّب الآن

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.