Method: spaces.messages.update

تعديل رسالة هناك فرق بين طريقة patch وupdate. تستخدِم طريقة patch طلب patch، بينما تستخدِم طريقة update طلب put. ننصح باستخدام الطريقة patch. على سبيل المثال، راجِع مقالة تعديل رسالة.

توفّر الأنواع التالية من المصادقة:

عند استخدام مصادقة التطبيقات، لا يمكن للطلبات تعديل إلا الرسائل التي تم إنشاؤها من خلال تطبيق Chat للاتصال.

طلب HTTP

PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

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

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

المعلمات
message.name

string

المعرّف اسم المورد للرسالة

تنسيق الملف: spaces/{space}/messages/{message}

حيث يكون {space} هو معرّف المساحة التي تم نشر الرسالة فيها و{message} هو معرّف تحدّده النظام للرسالة. مثلاً: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

في حال ضبط رقم تعريف مخصّص عند إنشاء رسالة، يمكنك استخدام هذا الرقم لتحديد الرسالة في طلب من خلال استبدال {message} بالقيمة من الحقل clientAssignedMessageId. مثلاً: spaces/AAAAAAAAAAA/messages/client-custom-name للحصول على التفاصيل، يُرجى الاطِّلاع على تسمية رسالة.

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

المعلمات
updateMask

string (FieldMask format)

مطلوب. مسارات الحقول التي سيتم تعديلها افصل بين القيم المتعدّدة بفواصل أو استخدِم * لتعديل جميع مسارات الحقول.

مسارات الحقول المتوافقة حاليًا:
allowMissing

boolean

اختياريّ. إذا لم يتم العثور على true والرسالة، يتم إنشاء رسالة جديدة ويتم تجاهل updateMask. يجب أن يكون معرّف الرسالة المحدّد من تحديد العميل وإلا سيتعذّر تنفيذ الطلب.

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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