Method: spaces.messages.delete

لحذف رسالة على سبيل المثال، راجِع حذف رسالة.

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

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

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

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

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

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

طلب HTTP

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

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

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

المعلمات
name

string

مطلوب. اسم المورد للرسالة

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

إذا كنت قد حدّدت معرّفًا مخصّصًا لرسالتك، يمكنك استخدام القيمة من حقل clientAssignedMessageId لـ {message}. لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة.

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

المعلمات
force

boolean

اختياريّ. عند true، يؤدي حذف رسالة إلى حذف الردود المتسلسلة لها أيضًا. عندما يكون الخيار false مفعَّلاً، إذا كانت الرسالة تتضمّن ردودًا في سلسلة محادثات، يتعذّر حذفها.

لا ينطبق إلا عند المصادقة بصفتك مستخدمًا. لا يؤثّر ذلك في المصادقة كتطبيق Chat.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة عنصر JSON فارغًا.

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

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

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

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