Method: spaces.messages.create

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لإنشاء رسالة. على سبيل المثال، للاستخدام، راجع إنشاء رسالة.

يتطلب المصادقة. يدعم مصادقة حساب الخدمة بالكامل.

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

طلب HTTP

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

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

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

المَعلمات
parent

string

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

التنسيق: مساحات العمل/{space}

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

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

string

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

requestId

string

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

messageReplyOption

enum (MessageReplyOption)

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

messageId

string

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

نص الطلب

يحتوي نص الطلب على مثال Message.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Message مُنشأ حديثًا.

نطاقات الأذونات

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

لمزيد من المعلومات، راجع نظرة عامة على OAuth 2.0.