Method: spaces.messages.replaceCards

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

لا يمكن لتطبيق محادثات استبدال البطاقات في رسالة أنشأها مستخدم إلا إذا كانت الرسالة تتضمّن بطاقات أنشأها التطبيق.

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

يتطلّب مصادقة التطبيق باستخدام نطاق التفويض: - 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

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