Method: spaces.messages.create

لإنشاء رسالة في مساحة Google Chat للاطّلاع على مثال، يُرجى الاطّلاع على إرسال رسالة.

تتطلّب طريقة create() إما مصادقة المستخدم أو مصادقة التطبيق. تُحدِّد Chat هوية مُرسِل الرسالة بشكلٍ مختلف استنادًا إلى نوع المصادقة الذي تستخدمه في طلبك.

توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة التطبيق. يعرض تطبيق Chat تطبيق Chat كمُرسِل الرسالة. يمكن أن يتضمّن محتوى الرسالة نصًا (text) وبطاقات (cardsV2) وتطبيقات مصغّرة لوظائف إضافية (accessoryWidgets).

رسالة تم إرسالها باستخدام مصادقة التطبيق

توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة المستخدم. يعرض Chat المستخدم كمُرسِل الرسالة وينسب تطبيق Chat إلى الرسالة من خلال عرض اسمه. يمكن أن يتضمّن محتوى الرسالة نصًا فقط (text).

رسالة تم إرسالها بعد مصادقة المستخدم

الحد الأقصى لحجم الرسالة، بما في ذلك محتوى الرسالة، هو 32,000 بايت.

بالنسبة إلى طلبات webhook، لا يحتوي الردّ على الرسالة الكاملة. لا يعبّئ الردّ سوى حقلَي name وthread.name بالإضافة إلى المعلومات الواردة في الطلب.

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