Method: spaces.messages.patch

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

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

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

طلب HTTP

PATCH 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. يجب أن يكون معرّف الرسالة المحدّد client-assigned وإلا سيتعذّر تنفيذ الطلب.

نص الطلب

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

نص الاستجابة

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

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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