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

الردّ

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

الأخطاء

يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على 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 للاتّصال بهذه الواجهة والاطّلاع على طلب البيانات والاستجابة من واجهة برمجة التطبيقات.