Method: spaces.messages.replaceCards

يستبدل البطاقات المضمّنة في رسالة.

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

إذا استبدل التطبيق البطاقات بقائمة فارغة، تتم إزالة البطاقات. بعد إزالة البطاقات، لا يمكن للتطبيق إضافتها مرة أخرى إلى الرسالة.

يتطلّب ذلك مصادقة التطبيق باستخدام نطاق التفويض: - https://www.googleapis.com/auth/chat.bot

طلب HTTP

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

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

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

المعلمات
name

string

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

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "cardsV2": [
    {
      object (CardWithId)
    }
  ]
}
الحقول
cardsV2[]

object (CardWithId)

اختيارية: مصفوفة من البطاقات التي سيتم تضمينها في الرسالة. ستحلّ هذه البطاقات محلّ البطاقات الحالية للرسالة. إذا كان الحقل فارغًا، ستتم إزالة البطاقات الأصلية المضمّنة في الرسالة.

نص الاستجابة

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

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

يجب توفير نطاق OAuth التالي:

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

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