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

لمزيد من المعلومات، راجِع دليل التفويض.