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

نص الطلب

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

نص الاستجابة

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

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

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

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

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