Method: spaces.messages.create

ينشئ رسالة في مساحة Google Chat. للحصول على مثال، راجِع إنشاء رسالة.

يتطلب طلب هذه الطريقة إجراء مصادقة ويتوافق مع أنواع المصادقة التالية:

  • بالنسبة إلى الرسائل النصية، تتوفّر مصادقة المستخدم أو مصادقة التطبيقات.
  • بالنسبة إلى رسائل البطاقات، يمكن استخدام مصادقة التطبيقات فقط. (يمكن لتطبيقات Chat فقط إنشاء رسائل بطاقات).

طلب HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

يجب ملء الحقل. اسم المورد للمساحة المراد إنشاء رسالة فيها.

تنسيق الملف: spaces/{space}

معلمات طلب البحث

المَعلمات
threadKey
(deprecated)

string

اختياريّ. مهملة: يمكنك استخدام thread.thread_key بدلاً منها. رقم تعريف سلسلة المحادثات. إمكانية استخدام ما يصل إلى 4,000 حرف لبدء سلسلة محادثات أو الإضافة إليها، أنشِئ رسالة وحدِّد السمة threadKey أو السمة thread.name. مثلاً، يمكنك الاطّلاع على بدء سلسلة محادثات أو الرد عليها.

requestId

string

اختياريّ. معرّف طلب فريد لهذه الرسالة يؤدي تحديد معرِّف طلب حالي إلى إرجاع الرسالة التي تم إنشاؤها بهذا المُعرّف بدلاً من إنشاء رسالة جديدة.

messageReplyOption

enum (MessageReplyOption)

اختياريّ. تحدِّد هذه السياسة ما إذا كانت الرسالة تبدأ سلسلة محادثات أو ردودًا على سلسلة محادثات. لا يمكن استخدامها إلا في المساحات المُعنونة.

messageId

string

اختياريّ. معرِّف مخصص لرسالة. يسمح هذا الخيار للتطبيقات في Chat بإرسال رسالة أو تحديثها أو حذفها بدون الحاجة إلى تخزين رقم التعريف الذي حدّده النظام في اسم مورد الرسالة (ممثل في حقل الرسالة name).

يجب أن تستوفي قيمة هذا الحقل المتطلبات التالية:

  • يبدأ بـ client-. على سبيل المثال، client-custom-name هو معرّف مخصّص صالح، في حين أنّ custom-name ليس معرّفًا.
  • يحتوي على ما يصل إلى 63 حرفًا وأحرف صغيرة وأرقام وواصلات فقط.
  • يكون فريدًا داخل المساحة لا يمكن لتطبيق 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 أو threadKey يتم تضمينها.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD لإنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من خلال thread ID أو threadKey. وإذا تعذّر ذلك، تبدأ الرسالة سلسلة محادثات جديدة بدلاً من ذلك.
REPLY_MESSAGE_OR_FAIL لإنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من خلال thread ID أو threadKey. في حال استخدام threadKey جديدة، يتم إنشاء سلسلة محادثات جديدة. إذا تعذَّر إنشاء الرسالة، سيتم عرض الخطأ NOT_FOUND بدلاً من ذلك.