Method: spaces.messages.create

لإنشاء رسالة في مساحة 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

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 بدلاً من ذلك.