Method: spaces.messages.patch

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

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

  • مصادقة التطبيق مع نطاق التفويض:

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

  • مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (مساحات وضع الاستيراد فقط)

عند استخدام مصادقة التطبيق، يمكن للطلبات تعديل الرسائل التي أنشأها تطبيق 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

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