- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- MessageReplyOption
- جرِّبه الآن
لإنشاء رسالة في مساحة Google Chat مثلاً، راجِع إرسال رسالة.
تتطلّب طريقة create()
إما مصادقة المستخدم أو مصادقة التطبيق. تختلف سمات مُرسِل الرسالة في Chat حسب نوع المصادقة التي تستخدمها في طلبك.
توضّح الصورة التالية كيفية تحديد تطبيق Chat لرسالة عند استخدام المصادقة على التطبيقات. يعرض تطبيق Chat تطبيق Chat باعتباره مُرسِل الرسالة. يمكن أن يتضمّن محتوى الرسالة نصًا (text
) وبطاقات (cardsV2
) وتطبيقات مصغّرة لوظائف إضافية (accessoryWidgets
).
توضّح الصورة التالية كيفية تحديد تطبيق Chat لرسالة عند استخدام مصادقة المستخدم. يعرض Chat المستخدم بصفته مُرسِل الرسالة وينسب تطبيق Chat إلى الرسالة من خلال عرض اسمه. يمكن أن يحتوي محتوى الرسالة على نص فقط (text
).
الحد الأقصى لحجم الرسالة، بما في ذلك محتوى الرسالة، هو 32,000 بايت.
طلب HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. اسم المورد للمساحة التي تريد إنشاء رسالة فيها. تنسيق الملف: |
مَعلمات طلب البحث
المعلمات | |
---|---|
threadKey |
اختياريّ. متوقّفة نهائيًا: استخدِم |
request |
اختياريّ. معرّف طلب فريد لهذه الرسالة يؤدي تحديد معرّف طلب حالي إلى عرض الرسالة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء رسالة جديدة. |
message |
اختياريّ. يحدِّد هذا الإعداد ما إذا كانت الرسالة تبدأ سلسلة محادثات أو تردّ على سلسلة محادثات. لا تتوفّر هذه الميزة إلا في المساحات المُسمّاة. |
message |
اختياريّ. معرّف مخصّص لرسالة معيّنة تتيح تطبيقات 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 بدلاً من ذلك. |