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