- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- MessageReplyOption
- جرِّبه الآن
ينشئ رسالة في مساحة Google Chat. ويبلغ الحد الأقصى لحجم الرسالة، بما في ذلك النص والبطاقات، 32000 بايت. على سبيل المثال، راجع إرسال رسالة.
يتطلب طلب هذه الطريقة إجراء مصادقة ويتوافق مع أنواع المصادقة التالية:
- بالنسبة إلى الرسائل النصية، تتوفّر مصادقة المستخدم أو مصادقة التطبيقات.
- بالنسبة إلى رسائل البطاقات، يمكن استخدام مصادقة التطبيقات فقط. (يمكن لتطبيقات Chat فقط إنشاء رسائل بطاقات).
طلب HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. اسم المورد للمساحة المراد إنشاء رسالة فيها. تنسيق الملف: |
معلمات طلب البحث
المَعلمات | |
---|---|
threadKey |
اختياريّ. مهملة: يمكنك استخدام |
requestId |
اختياريّ. معرّف طلب فريد لهذه الرسالة يؤدي تحديد معرِّف طلب حالي إلى إرجاع الرسالة التي تم إنشاؤها بهذا المُعرّف بدلاً من إنشاء رسالة جديدة. |
messageReplyOption |
اختياريّ. تحدِّد هذه السياسة ما إذا كانت الرسالة تبدأ سلسلة محادثات أو ردودًا على سلسلة محادثات. لا يمكن استخدامها إلا في المساحات المُعنونة. |
messageId |
اختياريّ. معرِّف مخصص لرسالة. يسمح هذا الخيار للتطبيقات في Chat بإرسال رسالة أو تحديثها أو حذفها بدون الحاجة إلى تخزين رقم التعريف الذي حدّده النظام في اسم مورد الرسالة (ممثل في حقل الرسالة يجب أن تستوفي قيمة هذا الحقل المتطلبات التالية:
لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة. |
نص الطلب
يحتوي نص الطلب على مثال Message
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Message
تم إنشاؤه حديثًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
MessageReplyOption
تحدِّد هذه السمة كيفية الردّ على رسالة. وقد تتم إضافة المزيد من الولايات في المستقبل.
عمليات التعداد | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
تلقائي: بدء سلسلة محادثات جديدة يؤدي استخدام هذا الخيار إلى تجاهل أي thread ID أو يتم تضمينها. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
لإنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من خلال thread ID أو . وإذا تعذّر ذلك، تبدأ الرسالة سلسلة محادثات جديدة بدلاً من ذلك. |
REPLY_MESSAGE_OR_FAIL |
لإنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من خلال thread ID أو . في حال استخدام threadKey جديدة، يتم إنشاء سلسلة محادثات جديدة. إذا تعذَّر إنشاء الرسالة، سيتم عرض الخطأ NOT_FOUND بدلاً من ذلك. |