LiveChatMessages: insert

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

تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 20 وحدة.

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

طلب

طلب 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.questionText (سلسلة): السؤال الرئيسي للاستطلاع
    • ‫snippet.pollDetails.metadata.options (مصفوفة): قائمة بعناصر الخيارات
    • المتطلبات: يجب تضمين عنصرَين كحدّ أدنى و4 عناصر كحدّ أقصى.
    • الترتيب: يتم عرض العناصر بالتسلسل حسب ترتيبها في القائمة.
    • يجب أن يحتوي كل عنصر في الصفيفة على ما يلي:
      • ‫optionText (سلسلة): النص المعروض لخيار الاستطلاع المحدّد

الردّ

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

الأخطاء

يوضّح الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب بيانات من هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Live Streaming API - الأخطاء.

نوع الخطأ تفاصيل الخطأ الوصف
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.