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