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