Method: spaces.messages.replaceCards

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

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

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

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
name

string

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

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

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

object ( CardWithId )

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

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ خالی است.

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

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

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

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