Method: spaces.messages.create

لإنشاء رسالة. للاطّلاع على مثال، يمكنك مراجعة إنشاء رسالة.

تتطلب المصادقة.

يتيح إنشاء رسالة نصية كلاً من مصادقة المستخدم ومصادقة التطبيقات. تتطلب مصادقة المستخدم نطاق تفويض chat.messages أو chat.messages.create.

لا يتيح إنشاء رسالة بطاقة إلا إجراء مصادقة التطبيق.

بما أنّ Chat يوفّر مصادقة للردود التلقائية على الويب كجزء من عنوان URL الذي يتم إنشاؤه عند تسجيل ردّ تلقائي على الويب، يمكن أن تنشئ الردود التلقائية على الويب رسائل بدون حساب حساب أو مصادقة مستخدم.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
parent

string

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

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

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

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

string

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

requestId

string

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

messageReplyOption

enum (MessageReplyOption)

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

messageId

string

اختياريّ. اسم مخصَّص لرسالة Chat تم تخصيصها عند الإنشاء. يجب أن يبدأ المعرّف بـ client- وأن يحتوي على أحرف وأرقام وواصلات صغيرة لا يتجاوز طولها 63 حرفًا. حدِّد هذا الحقل للحصول على الرسالة أو تعديلها أو حذفها باستخدام القيمة المحدَّدة. يؤدي تخصيص اسم مخصّص إلى السماح لتطبيق Chat بتذكُّر الرسالة بدون حفظ الرسالة name من نص الاستجابة المعروض عند إنشاء الرسالة. لا يؤدي تخصيص اسم مخصّص إلى استبدال حقل name الذي تم إنشاؤه، وهو اسم مورد الرسالة. وبدلاً من ذلك، تحدِّد هذه السياسة الاسم المخصّص كحقل clientAssignedMessageId الذي يمكنك الإشارة إليه أثناء معالجة العمليات اللاحقة، مثل تعديل الرسالة أو حذفها. على سبيل المثال، يمكنك الاطّلاع على تسمية رسالة تم إنشاؤها.

نص الطلب

يحتوي نص الطلب على مثال 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

لمزيد من المعلومات، اطّلِع على دليل التفويض.

خيار الرد على الرسائل

تحديد كيفية الرد على رسالة وقد تتم إضافة المزيد من الولايات في المستقبل.

عمليات التعداد
MESSAGE_REPLY_OPTION_UNSPECIFIED تلقائي: بدء سلسلة محادثات
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD يتم إنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من قِبل thread ID أو threadKey. وإذا تعذَّر ذلك، تبدأ الرسالة سلسلة محادثات جديدة بدلاً من ذلك.
REPLY_MESSAGE_OR_FAIL يتم إنشاء الرسالة كرد على سلسلة المحادثات المحدّدة من قِبل thread ID أو threadKey. وإذا تعذّر إتمامها، سيتم عرض خطأ NOT_FOUND بدلاً من ذلك.