Method: spaces.messages.replaceCards

کارت‌های موجود در پیام را جایگزین می‌کند.

برنامه Chat فقط درصورتی می‌تواند کارت‌ها را در پیام ایجادشده توسط انسان جایگزین کند که پیام ازقبل حاوی کارت باشد و کارت‌ها توسط برنامه ایجاد شده باشند.

اگر برنامه کارت‌ها را با فهرست خالی جایگزین کند، کارت‌ها برداشته می‌شوند. پس‌از برداشتن کارت‌ها، برنامه نمی‌تواند کارت‌ها را دوباره به پیام اضافه کند.

به اصالت‌سنجی برنامه با دامنه مجوز نیاز دارد: - https://www.googleapis.com/auth/chat.bot

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع پیام.

قالب: spaces/{space}/messages/{message}

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "cardsV2": [
    {
      object (CardWithId)
    }
  ]
}
فیلدها
cardsV2[]

object (CardWithId)

اختیاری. آرایه‌ای از کارت‌ها که باید در پیام گنجانده شود. این کارت‌ها جایگزین کارت‌های موجود پیام خواهند شد. اگر خالی باشد، کارت‌های اصلی موجود در پیام پاک خواهد شد.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ خالی است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، راهنمای صدور مجوز را ببینید.