Cards v2

کارت

رابط کارتی که در پیام Google Chat یا افزونه Google Workspace نمایش داده می‌شود.

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

طراحی و پیش نمایش کارت ها با Card Builder.

کارت ساز را باز کنید

برای یادگیری نحوه ساخت کارت، به مستندات زیر مراجعه کنید:

توجه: شما می توانید تا 100 ویجت در هر کارت اضافه کنید. هر ویجت فراتر از این حد نادیده گرفته می شود. این محدودیت هم برای پیام‌ها و گفتگوهای کارت در برنامه‌های چت Google و هم برای کارت‌های موجود در افزونه‌های Google Workspace اعمال می‌شود.

مثال: پیام کارت برای برنامه Google Chat

نمونه کارت تماس

برای ایجاد پیام کارت نمونه در Google Chat، از JSON زیر استفاده کنید:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
نمایندگی JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  }
}
فیلدها
header

object ( CardHeader )

هدر کارت. یک هدر معمولا حاوی یک تصویر اصلی و یک عنوان است. هدرها همیشه در بالای کارت ظاهر می شوند.

sections[]

object ( Section )

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

section Divider Style

enum ( DividerStyle )

سبک تقسیم کننده بین هدر، بخش ها و پاورقی.

card Actions[]

object ( CardAction )

اقدامات کارت اقدامات به منوی نوار ابزار کارت اضافه می شود.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

به عنوان مثال، JSON زیر یک منوی عملکرد کارت با گزینه‌های Settings و Send Feedback ایجاد می‌کند:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

نام کارت. به عنوان شناسه کارت در ناوبری کارت استفاده می شود.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

display Style

enum ( DisplayStyle )

در افزونه‌های Google Workspace، ویژگی‌های نمایش peekCardHeader را تنظیم می‌کند.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

peek Card Header

object ( CardHeader )

هنگام نمایش محتوای متنی، هدر کارت به عنوان یک مکان نگهدار عمل می کند تا کاربر بتواند بین کارت های صفحه اصلی و کارت های متنی به جلو حرکت کند.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

سربرگ کارت

نشان دهنده هدر کارت است. برای مثال در برنامه‌های گپ Google، به افزودن سرصفحه مراجعه کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
فیلدها
title

string

مورد نیاز. عنوان هدر کارت. سربرگ دارای ارتفاع ثابتی است: اگر عنوان و عنوان فرعی هر دو مشخص شده باشند، هر کدام یک خط را اشغال می کنند. اگر فقط عنوان مشخص شده باشد، هر دو خط را می گیرد.

subtitle

string

زیرنویس هدر کارت. در صورت مشخص شدن، در خط خودش زیر title ظاهر می شود.

image Type

enum ( ImageType )

شکلی که برای برش تصویر استفاده می شود.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

image Url

string

نشانی وب HTTPS تصویر در هدر کارت.

image Alt Text

string

متن جایگزین این تصویر که برای دسترس‌پذیری استفاده می‌شود.

ImageType

شکلی که برای برش تصویر استفاده می شود.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

Enums
SQUARE مقدار پیش فرض یک ماسک مربعی روی تصویر اعمال می کند. به عنوان مثال، یک تصویر 4x3 تبدیل به 3x3 می شود.
CIRCLE ماسک دایره ای را روی تصویر اعمال می کند. به عنوان مثال، یک تصویر 4x3 به دایره ای با قطر 3 تبدیل می شود.

بخش

یک بخش شامل مجموعه ای از ویجت ها است که به صورت عمودی به ترتیبی که مشخص شده اند ارائه می شوند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "collapseControl": {
    object (CollapseControl)
  }
}
فیلدها
header

string

متنی که در بالای یک بخش ظاهر می شود. پشتیبانی از متن ساده با فرمت HTML. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

widgets[]

object ( Widget )

تمام ویجت های موجود در بخش باید حداقل یک ویجت داشته باشد.

collapsible

boolean

نشان می دهد که آیا این بخش قابل جمع شدن است یا خیر.

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

برای تعیین اینکه کدام ویجت‌ها پنهان هستند، uncollapsibleWidgetsCount را مشخص کنید.

uncollapsible Widgets Count

integer

تعداد ویجت‌های جمع نشدنی که حتی در صورت جمع شدن یک بخش قابل مشاهده باقی می‌مانند.

به عنوان مثال، هنگامی که یک بخش شامل پنج ویجت است و uncollapsibleWidgetsCount روی 2 تنظیم می شود، دو ویجت اول همیشه نشان داده می شوند و سه ویجت آخر به طور پیش فرض جمع می شوند. uncollapsibleWidgetsCount تنها زمانی در نظر گرفته می‌شود که collapsible true باشد.

collapse Control

object ( CollapseControl )

اختیاری. دکمه گسترش و کوچک کردن بخش را تعریف کنید. این دکمه فقط در صورتی نشان داده می شود که بخش قابل جمع شدن باشد. اگر این فیلد تنظیم نشده باشد، از دکمه پیش فرض استفاده می شود.

ویجت

هر کارت از ویجت ها تشکیل شده است.

ویجت یک شی ترکیبی است که می تواند یکی از متن، تصاویر، دکمه ها و دیگر انواع شی را نشان دهد.

نمایندگی JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}
فیلدها
horizontal Alignment

enum ( HorizontalAlignment )

تعیین می کند که آیا ویجت ها در سمت چپ، راست یا مرکز یک ستون تراز شوند.

data میدان اتحادیه یک ویجت فقط می تواند یکی از موارد زیر را داشته باشد. می توانید از چندین فیلد ویجت برای نمایش موارد بیشتر استفاده کنید. data فقط می توانند یکی از موارد زیر باشند:
text Paragraph

object ( TextParagraph )

یک پاراگراف متنی را نمایش می دهد. پشتیبانی از متن ساده با فرمت HTML. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

به عنوان مثال، JSON زیر یک متن پررنگ ایجاد می کند:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

object ( Image )

تصویری را نمایش می دهد.

به عنوان مثال، JSON زیر یک تصویر با متن جایگزین ایجاد می کند:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decorated Text

object ( DecoratedText )

یک مورد متن تزئین شده را نمایش می دهد.

به عنوان مثال، JSON زیر یک ویجت متن تزئین شده ایجاد می کند که آدرس ایمیل را نشان می دهد:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
button List

object ( ButtonList )

لیستی از دکمه ها

به عنوان مثال، JSON زیر دو دکمه ایجاد می کند. اولی یک دکمه متن آبی و دومی یک دکمه تصویر است که یک پیوند را باز می کند: 

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
text Input

object ( TextInput )

کادر متنی را نمایش می دهد که کاربران می توانند در آن تایپ کنند.

به عنوان مثال، JSON زیر یک ورودی متنی برای آدرس ایمیل ایجاد می کند: 

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

به عنوان مثال دیگری، JSON زیر یک ورودی متنی برای یک زبان برنامه نویسی با پیشنهادات ثابت ایجاد می کند: 

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selection Input

object ( SelectionInput )

یک کنترل انتخاب را نمایش می دهد که به کاربران امکان می دهد موارد را انتخاب کنند. کنترل‌های انتخاب می‌توانند چک باکس، دکمه‌های رادیویی، سوئیچ‌ها یا منوهای کشویی باشند.

به عنوان مثال، JSON زیر یک منوی کشویی ایجاد می کند که به کاربران امکان می دهد اندازه ای را انتخاب کنند: 

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
date Time Picker

object ( DateTimePicker )

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

برای مثال، JSON زیر یک انتخابگر زمان برای زمان‌بندی قرار ایجاد می‌کند: 

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}
divider

object ( Divider )

یک تقسیم کننده خط افقی بین ویجت ها را نمایش می دهد.

به عنوان مثال، JSON زیر یک تقسیم کننده ایجاد می کند: 

"divider": {
}
grid

object ( Grid )

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

یک شبکه از هر تعداد ستون و آیتم پشتیبانی می کند. تعداد سطرها با کران های بالای آیتم های عددی تقسیم بر تعداد ستون ها تعیین می شود. یک شبکه با 10 مورد و 2 ستون دارای 5 ردیف است. یک شبکه با 11 مورد و 2 ستون دارای 6 ردیف است.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

به عنوان مثال، JSON زیر یک شبکه 2 ستونی با یک آیتم ایجاد می کند: 

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

object ( Columns )

حداکثر 2 ستون را نمایش می دهد.

برای گنجاندن بیش از 2 ستون یا استفاده از سطرها، از ویجت Grid استفاده کنید.

به عنوان مثال، JSON زیر 2 ستون ایجاد می کند که هر کدام شامل پاراگراف های متنی است: 

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

object ( Carousel )

یک چرخ فلک شامل مجموعه ای از ویجت های تودرتو است. به عنوان مثال، این یک نمایش JSON از یک چرخ فلک است که شامل دو پاراگراف متنی است. 

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}
chip List

object ( ChipList )

لیستی از تراشه ها

به عنوان مثال، JSON زیر دو تراشه ایجاد می کند. اولی یک تراشه متنی و دومی یک تراشه نماد است که پیوندی را باز می کند: 

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

متن پاراگراف

پاراگراف متنی که از قالب بندی پشتیبانی می کند. برای مثال در برنامه‌های گپ Google، به افزودن پاراگراف متن قالب‌بندی شده مراجعه کنید. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "text": string,
  "maxLines": integer
}
فیلدها
text

string

متنی که در ویجت نشان داده شده است.

max Lines

integer

حداکثر تعداد خطوط متنی که در ویجت نمایش داده می شود. اگر متن از حداکثر تعداد خطوط تعیین شده بیشتر شود، محتوای اضافی در پشت دکمه نمایش بیشتر پنهان می شود. اگر متن مساوی یا کوتاهتر از حداکثر تعداد خطوط تعیین شده باشد، دکمه نمایش بیشتر نمایش داده نمی شود.

مقدار پیش فرض 0 است که در این حالت تمام زمینه نمایش داده می شود. ارزش های منفی نادیده گرفته می شوند.

تصویر

تصویری که توسط یک URL مشخص می شود و می تواند یک عمل onClick داشته باشد. برای مثال، افزودن تصویر را ببینید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
فیلدها
image Url

string

URL HTTPS که تصویر را میزبانی می کند.

به عنوان مثال: 

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
on Click

object ( OnClick )

وقتی کاربر روی تصویر کلیک می کند، کلیک این عمل را آغاز می کند.

alt Text

string

متن جایگزین این تصویر که برای دسترس‌پذیری استفاده می‌شود.

OnClick

نشان دهنده نحوه پاسخ دادن به زمانی است که کاربران روی یک عنصر تعاملی روی کارت، مانند یک دکمه کلیک می کنند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  },
  "overflowMenu": {
    object (OverflowMenu)
  }
  // End of list of possible types for union field data.
}
فیلدها

data میدان اتحادیه

data فقط می توانند یکی از موارد زیر باشند:

action

object ( Action )

اگر مشخص شده باشد، یک عمل با این onClick فعال می شود.

card

object ( Card )

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

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

overflow Menu

object ( OverflowMenu )

اگر مشخص شده باشد، این onClick منوی سرریز را باز می کند.

اقدام

اقدامی که رفتار را هنگام ارسال فرم توصیف می کند. به عنوان مثال، می توانید یک اسکریپت Apps Script را برای مدیریت فرم فراخوانی کنید. اگر عمل فعال شود، مقادیر فرم به سرور ارسال می شود.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction),
  "requiredWidgets": [
    string
  ],
  "allWidgetsAreRequired": boolean
}
فیلدها
function

string

یک تابع سفارشی برای فراخوانی زمانی که عنصر حاوی کلیک یا فعال می شود.

برای مثال استفاده، به خواندن داده‌های فرم مراجعه کنید.

parameters[]

object ( ActionParameter )

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

load Indicator

enum ( LoadIndicator )

نشانگر بارگیری را مشخص می کند که عملکرد هنگام تماس با کنش نمایش داده می شود.

persist Values

boolean

نشان می دهد که آیا مقادیر فرم پس از عمل باقی می مانند یا خیر. مقدار پیش فرض false است.

اگر true ، مقادیر فرم پس از راه اندازی عمل باقی می مانند. برای اینکه کاربر در حین پردازش عملکرد تغییراتی ایجاد کند، LoadIndicator روی NONE تنظیم کنید. برای پیام‌های کارت در برنامه‌های گپ، همچنین باید ResponseType عملکرد را روی UPDATE_MESSAGE تنظیم کنید و از همان cardId کارتی که حاوی کنش است استفاده کنید.

اگر false ، مقادیر فرم هنگام شروع عمل پاک می شوند. برای جلوگیری از ایجاد تغییرات توسط کاربر در حین پردازش، LoadIndicator روی SPINNER تنظیم کنید.

interaction

enum ( Interaction )

اختیاری. هنگام باز کردن یک گفتگو الزامی است.

در پاسخ به تعامل با کاربر، مانند کلیک کردن روی دکمه در پیام کارت، چه کاری باید انجام دهید.

اگر مشخص نباشد، برنامه با اجرای یک action - مانند باز کردن یک پیوند یا اجرای یک تابع - به طور معمول پاسخ می دهد.

با مشخص کردن یک interaction ، برنامه می‌تواند به روش‌های تعاملی ویژه پاسخ دهد. برای مثال، با تنظیم interaction روی OPEN_DIALOG ، برنامه می‌تواند یک گفتگو را باز کند. وقتی مشخص شد، نشانگر بارگیری نشان داده نمی شود. اگر برای یک افزونه مشخص شده باشد، کل کارت حذف می شود و چیزی در مشتری نشان داده نمی شود.

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

required Widgets[]

string

اختیاری. این لیست را با نام ویجت هایی که این Action برای ارسال معتبر به آن نیاز دارد پر کنید.

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

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

all Widgets Are Required

boolean

اختیاری. اگر این درست باشد، تمام ویجت ها برای این عمل مورد نیاز در نظر گرفته می شوند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

ActionParameter

فهرست پارامترهای رشته ای که باید هنگام فراخوانی متد اقدام ارائه شوند. به عنوان مثال، سه دکمه چرت زدن را در نظر بگیرید: به تعویق انداختن اکنون، به تعویق انداختن یک روز، یا به تعویق انداختن هفته بعد. شما ممکن است از action method = snooze() استفاده کنید، از نوع snooze و زمان snooze در لیست پارامترهای رشته استفاده کنید.

برای کسب اطلاعات بیشتر، CommonEventObject ببینید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "key": string,
  "value": string
}
فیلدها
key

string

نام پارامتر برای اسکریپت اکشن.

value

string

مقدار پارامتر.

LoadIndicator

نشانگر بارگیری را مشخص می کند که عملکرد هنگام تماس با کنش نمایش داده می شود.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

Enums
SPINNER یک اسپینر را نشان می دهد که نشان می دهد محتوا در حال بارگیری است.
NONE چیزی نمایش داده نمی شود.

تعامل

اختیاری. هنگام باز کردن یک گفتگو الزامی است.

در پاسخ به تعامل با کاربر، مانند کلیک کردن روی دکمه در پیام کارت، چه کاری باید انجام دهید.

اگر مشخص نباشد، برنامه با اجرای یک action - مانند باز کردن یک پیوند یا اجرای یک تابع - به طور معمول پاسخ می دهد.

با مشخص کردن یک interaction ، برنامه می‌تواند به روش‌های تعاملی ویژه پاسخ دهد. برای مثال، با تنظیم interaction روی OPEN_DIALOG ، برنامه می‌تواند یک گفتگو را باز کند.

وقتی مشخص شد، نشانگر بارگیری نشان داده نمی شود. اگر برای یک افزونه مشخص شده باشد، کل کارت حذف می شود و چیزی در مشتری نشان داده نمی شود.

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

Enums
INTERACTION_UNSPECIFIED مقدار پیش فرض action به طور معمول اجرا می شود.
OPEN_DIALOG

گفتگویی را باز می‌کند، یک رابط پنجره‌دار و مبتنی بر کارت که برنامه‌های گپ از آن برای تعامل با کاربران استفاده می‌کنند.

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

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

OpenAs

هنگامی که یک کنش OnClick پیوندی را باز می کند، مشتری می تواند آن را به عنوان یک پنجره با اندازه کامل (اگر این قاب مورد استفاده مشتری باشد) یا یک پوشش (مانند یک پنجره بازشو) باز کند. پیاده‌سازی به قابلیت‌های پلتفرم مشتری بستگی دارد و اگر مشتری از آن پشتیبانی نکند، ممکن است مقدار انتخاب شده نادیده گرفته شود. FULL_SIZE توسط همه مشتریان پشتیبانی می شود.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

Enums
FULL_SIZE پیوند به عنوان یک پنجره با اندازه کامل باز می شود (اگر این قاب مورد استفاده مشتری باشد).
OVERLAY پیوند به عنوان یک پوشش باز می شود، مانند یک پاپ آپ.

OnClose

وقتی یک پیوند باز شده توسط یک عمل OnClick بسته می شود، مشتری چه کاری انجام می دهد.

پیاده سازی به قابلیت های پلت فرم مشتری بستگی دارد. به عنوان مثال، یک مرورگر وب ممکن است پیوندی را در یک پنجره بازشو با یک کنترل کننده OnClose باز کند.

اگر هر دو کنترل کننده OnOpen و OnClose تنظیم شده باشند و پلت فرم مشتری نتواند از هر دو مقدار پشتیبانی کند، OnClose اولویت دارد.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

Enums
NOTHING مقدار پیش فرض کارت دوباره بارگیری نمی شود. هیچ اتفاقی نمی افتد
RELOAD

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

اگر همراه با OpenAs.OVERLAY استفاده شود، پنجره فرزند به عنوان یک گفتگوی معین عمل می کند و کارت والد تا بسته شدن پنجره فرزند مسدود می شود.

منوی سرریز

ویجتی که یک منوی پاپ آپ را با یک یا چند عمل ارائه می دهد که کاربران می توانند آنها را فراخوانی کنند. به عنوان مثال، نمایش اقدامات غیراصولی در یک کارت. وقتی اقدامات در فضای موجود جا نمی‌شوند، می‌توانید از این ویجت استفاده کنید. برای استفاده، این ویجت را در اقدام OnClick ویجت هایی که از آن پشتیبانی می کنند، مشخص کنید. به عنوان مثال، در یک Button .

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "items": [
    {
      object (OverflowMenuItem)
    }
  ]
}
فیلدها
items[]

object ( OverflowMenuItem )

مورد نیاز. لیست گزینه های منو

OverflowMenuItem

گزینه ای که کاربران می توانند در منوی سرریز آن را فراخوانی کنند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "startIcon": {
    object (Icon)
  },
  "text": string,
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean
}
فیلدها
start Icon

object ( Icon )

نمادی که در جلوی متن نمایش داده می شود.

text

string

مورد نیاز. متنی که مورد را برای کاربران شناسایی یا توصیف می کند.

on Click

object ( OnClick )

مورد نیاز. عملی که هنگام انتخاب گزینه منو فراخوانی می شود. این OnClick نمی‌تواند شامل منوی OverflowMenu باشد، هر OverflowMenu مشخص شده حذف می‌شود و آیتم منو غیرفعال می‌شود.

disabled

boolean

آیا گزینه منو غیرفعال است یا خیر. پیش فرض به نادرست.

نماد

نمادی که در ویجت روی کارت نمایش داده می شود. برای مثال در برنامه‌های گپ Google، به افزودن نماد مراجعه کنید.

پشتیبانی از آیکون های داخلی و سفارشی

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
  // End of list of possible types for union field icons.
}
فیلدها
alt Text

string

اختیاری. شرح نماد مورد استفاده برای دسترسی. اگر مشخص نشده باشد، Button مقدار پیش فرض ارائه می شود. به عنوان بهترین روش، باید توضیحات مفیدی را برای آنچه نماد نمایش می دهد، و در صورت وجود، کاری که انجام می دهد تنظیم کنید. به عنوان مثال، A user's account portrait ، یا Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat .

اگر نماد در یک Button تنظیم شده باشد، وقتی کاربر روی دکمه قرار می گیرد، altText به عنوان متن کمکی ظاهر می شود. با این حال، اگر دکمه text نیز تنظیم کند، altText نماد نادیده گرفته می‌شود.

image Type

enum ( ImageType )

سبک برش به تصویر اعمال می شود. در برخی موارد، اعمال برش CIRCLE باعث می شود که تصویر بزرگتر از یک نماد داخلی کشیده شود.

icons فیلد اتحادیه نماد نمایش داده شده در ویجت روی کارت. icons فقط می توانند یکی از موارد زیر باشند:
known Icon

string

یکی از نمادهای داخلی ارائه شده توسط Google Workspace را نمایش دهید.

به عنوان مثال، برای نمایش نماد هواپیما، AIRPLANE مشخص کنید. برای اتوبوس، BUS مشخص کنید.

برای فهرست کامل نمادهای پشتیبانی شده، به نمادهای داخلی مراجعه کنید.

icon Url

string

یک نماد سفارشی که در یک URL HTTPS میزبانی شده است را نمایش دهید.

به عنوان مثال: 

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

انواع فایل های پشتیبانی شده عبارتند از .png و .jpg .

material Icon

object ( MaterialIcon )

یکی از نمادهای Google Material را نمایش دهید.

به عنوان مثال، برای نمایش نماد چک باکس ، استفاده کنید 

"materialIcon": {
  "name": "check_box"
}

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

MaterialIcon

یک نماد Google Material ، که شامل بیش از 2500 گزینه است.

به عنوان مثال، برای نمایش نماد چک باکس با وزن و درجه سفارشی، موارد زیر را بنویسید: 

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

نمایندگی JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
فیلدها
name

string

نام نماد تعریف شده در نماد Google Material ، به عنوان مثال، check_box . نام‌های نامعتبر کنار گذاشته می‌شوند و با رشته‌های خالی جایگزین می‌شوند و باعث می‌شود نماد نمایش داده نشود.

fill

boolean

آیا نماد پر شده است. مقدار پیش فرض نادرست است.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

weight

integer

وزن ضربه ای نماد. از بین {100، 200، 300، 400، 500، 600، 700} انتخاب کنید. در صورت عدم وجود، مقدار پیش فرض 400 است. اگر مقدار دیگری مشخص شده باشد، از مقدار پیش فرض استفاده می شود.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

grade

integer

وزن و درجه بر ضخامت نماد تأثیر می گذارد. تنظیمات درجه نسبت به تنظیم وزن دانه بندی بیشتری دارند و تأثیر کمی بر اندازه نماد دارند. از بین {-25، 0، 200} انتخاب کنید. در صورت عدم وجود، مقدار پیش فرض 0 است. اگر مقدار دیگری مشخص شده باشد، از مقدار پیش فرض استفاده می شود.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

متن تزئین شده

ویجتی که متنی را با تزئینات اختیاری مانند برچسب در بالا یا پایین متن، نماد جلوی متن، ویجت انتخاب یا دکمه بعد از متن نمایش می دهد. برای مثال در برنامه‌های چت Google، به نمایش متن با متن تزئینی مراجعه کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "topLabel": string,
  "text": string,
  "wrapText": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
  // End of list of possible types for union field control.
}
فیلدها
icon
(deprecated)

object ( Icon )

به نفع startIcon منسوخ شد.

start Icon

object ( Icon )

نمادی که در جلوی متن نمایش داده می شود.

top Label

string

متنی که در بالای text ظاهر می شود. همیشه کوتاه می شود.

text

string

مورد نیاز. متن اولیه

از قالب بندی ساده پشتیبانی می کند. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

wrap Text

boolean

تنظیم متن بسته بندی. اگر true ، متن در چندین خط پیچیده و نمایش داده می شود. در غیر این صورت، متن کوتاه شده است.

فقط برای text اعمال می شود، نه topLabel و bottomLabel .

bottom Label

string

متنی که در زیر text ظاهر می شود. همیشه می پیچد.

on Click

object ( OnClick )

این عمل زمانی فعال می شود که کاربران topLabel یا bottomLabel را کلیک کنند.

control میدان اتحادیه یک دکمه، سوئیچ، کادر انتخاب یا تصویری که در سمت راست متن در ویجت decoratedText متن ظاهر می شود. control فقط می تواند یکی از موارد زیر باشد:
button

object ( Button )

دکمه‌ای که کاربر می‌تواند روی آن کلیک کند تا یک اقدام را فعال کند.

switch Control

object ( SwitchControl )

ویجت سوئیچ که کاربر می تواند روی آن کلیک کند تا وضعیت آن را تغییر دهد و یک عمل را آغاز کند.

end Icon

object ( Icon )

یک نماد بعد از متن نمایش داده می شود.

پشتیبانی از آیکون های داخلی و سفارشی

دکمه

یک متن، نماد یا دکمه متن و نماد که کاربران می توانند روی آن کلیک کنند. برای مثال در برنامه‌های گپ Google، به افزودن دکمه مراجعه کنید.

برای تبدیل کردن یک تصویر به یک دکمه قابل کلیک، یک Image (نه ImageComponent ) را مشخص کنید و یک عمل onClick را تنظیم کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
فیلدها
text

string

متن نمایش داده شده در داخل دکمه

icon

object ( Icon )

یک نماد در داخل دکمه نمایش داده می شود. اگر icon و text هر دو تنظیم شده باشند، نماد قبل از متن ظاهر می شود.

color

object ( Color )

اختیاری. رنگ دکمه. در صورت تنظیم، type دکمه روی FILLED و رنگ text و قسمت icon برای خوانایی روی رنگ متضاد تنظیم می شود. به عنوان مثال، اگر رنگ دکمه روی آبی تنظیم شده باشد، هر متن یا نمادی در دکمه روی سفید تنظیم می شود.

برای تنظیم رنگ دکمه، مقداری برای فیلدهای red ، green و blue مشخص کنید. مقدار باید یک عدد شناور بین 0 و 1 بر اساس مقدار رنگ RGB باشد، که در آن 0 (0/255) نشان دهنده عدم وجود رنگ و 1 (255/255) نشان دهنده حداکثر شدت رنگ است.

به عنوان مثال، رنگ زیر را در حداکثر شدت آن بر روی قرمز تنظیم می کند: 

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

فیلد alpha برای رنگ دکمه در دسترس نیست. اگر مشخص شده باشد، این فیلد نادیده گرفته می شود.

on Click

object ( OnClick )

مورد نیاز. اقدامی که هنگام کلیک کاربر روی دکمه انجام می شود، مانند باز کردن یک پیوند یا اجرای یک عملکرد سفارشی.

disabled

boolean

اگر true ، دکمه در حالت غیرفعال نمایش داده می شود و به اقدامات کاربر پاسخ نمی دهد.

alt Text

string

متن جایگزینی که برای دسترسی استفاده می شود.

متن توصیفی را تنظیم کنید که به کاربران اجازه دهد بدانند دکمه چه کاری انجام می دهد. برای مثال، اگر دکمه‌ای یک پیوند را باز می‌کند، می‌توانید بنویسید: «یک برگه مرورگر جدید را باز می‌کند و به اسناد توسعه‌دهنده Google Chat در https://developers.google.com/workspace/chat می‌رود» .

type

enum ( Type )

اختیاری. نوع یک دکمه. اگر تنظیم نشده باشد، نوع دکمه پیش‌فرض OUTLINED است. اگر فیلد color تنظیم شود، نوع دکمه به اجبار FILLED می شود و هر مقدار تنظیم شده برای این فیلد نادیده گرفته می شود.

رنگ

یک رنگ را در فضای رنگی RGBA نشان می دهد. این نمایش برای سادگی تبدیل به و از نمایش رنگ در زبان های مختلف بیش از فشرده سازی طراحی شده است. به عنوان مثال، فیلدهای این نمایش را می توان به صورت بی اهمیت در اختیار سازنده java.awt.Color در جاوا قرار داد. همچنین می‌توان آن را به روش UIColor +colorWithRed:green:blue:alpha در iOS ارائه کرد. و فقط با کمی کار می توان آن را به راحتی در یک رشته CSS rgba() در جاوا اسکریپت قالب بندی کرد.

این صفحه مرجع اطلاعاتی درباره فضای رنگ مطلقی که باید برای تفسیر مقدار RGB استفاده شود ندارد - برای مثال، sRGB، Adobe RGB، DCI-P3، و BT.2020. به طور پیش فرض، برنامه ها باید فضای رنگی sRGB را در نظر بگیرند.

هنگامی که نیاز به تصمیم گیری در مورد برابری رنگ است، پیاده سازی ها، مگر اینکه به گونه ای دیگر مستند شده باشد، اگر تمام مقادیر قرمز، سبز، آبی و آلفا هر کدام حداکثر 1e-5 متفاوت باشد، با دو رنگ برابر رفتار می کنند.

مثال (جاوا): 

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

مثال (iOS / Obj-C): 

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

مثال (جاوا اسکریپت): 

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
نمایندگی JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
فیلدها
red

number

مقدار قرمز در رنگ به عنوان مقدار در بازه [0، 1].

green

number

مقدار سبز در رنگ به عنوان مقدار در بازه [0، 1].

blue

number

مقدار آبی در رنگ به عنوان مقدار در بازه [0، 1].

alpha

number

کسری از این رنگ که باید روی پیکسل اعمال شود. یعنی رنگ پیکسل نهایی با معادله تعریف می شود:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

این بدان معنی است که مقدار 1.0 مربوط به یک رنگ ثابت است، در حالی که مقدار 0.0 مربوط به یک رنگ کاملا شفاف است. این به جای یک اسکالر شناور ساده از یک پیام پوششی استفاده می کند تا بتوان بین یک مقدار پیش فرض و مقدار تنظیم نشده تمایز قائل شد. اگر حذف شود، این شیء رنگی به صورت یک رنگ ثابت نمایش داده می شود (مثل اینکه مقدار آلفا به صراحت مقدار 1.0 داده شده است).

تایپ کنید

اختیاری. نوع یک دکمه. اگر فیلد color تنظیم شده باشد، type به اجبار FILLED می شود.

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

Enums
TYPE_UNSPECIFIED استفاده نکنید. نامشخص
OUTLINED دکمه های مشخص شده دکمه هایی با تاکید متوسط ​​هستند. آنها معمولاً حاوی اقدامات مهم هستند، اما اقدام اصلی در یک برنامه چت یا یک افزونه نیستند.
FILLED یک دکمه پر شده دارای ظرفی با رنگ ثابت است. بیشترین تأثیر بصری را دارد و برای اقدامات مهم و اولیه در یک برنامه چت یا یک افزونه توصیه می شود.
FILLED_TONAL یک دکمه تونال پر شده یک نقطه میانی جایگزین بین دکمه های پر شده و مشخص شده است. آنها در شرایطی که دکمه با اولویت کمتر به تاکید کمی بیشتر از یک دکمه طرح کلی نیاز دارد مفید هستند.
BORDERLESS یک دکمه در حالت پیش فرض خود محفظه نامرئی ندارد. اغلب برای اقدامات با کمترین اولویت استفاده می شود، به خصوص هنگام ارائه چندین گزینه.

SwitchControl

یا یک سوئیچ به سبک تغییر وضعیت یا یک چک باکس در داخل ویجت decoratedText .

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

فقط در ویجت decoratedText پشتیبانی می شود.

نمایندگی JSON 
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
فیلدها
name

string

نامی که با آن ویجت سوئیچ در یک رویداد ورودی فرم شناسایی می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

value

string

مقدار وارد شده توسط کاربر، به عنوان بخشی از یک رویداد ورودی فرم برگردانده می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

selected

boolean

وقتی true ، سوئیچ انتخاب می شود.

on Change Action

object ( Action )

عملکردی که باید هنگام تغییر وضعیت سوئیچ انجام شود، مانند اینکه چه عملکردی باید اجرا شود.

control Type

enum ( ControlType )

نحوه نمایش سوئیچ در رابط کاربری

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نوع کنترل

نحوه نمایش سوئیچ در رابط کاربری

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

Enums
SWITCH سوئیچ به سبک ضامن.
CHECKBOX به نفع CHECK_BOX منسوخ شد.
CHECK_BOX یک چک باکس.

ButtonList

لیستی از دکمه ها که به صورت افقی قرار گرفته اند. برای مثال در برنامه‌های گپ Google، به افزودن دکمه مراجعه کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "buttons": [
    {
      object (Button)
    }
  ]
}
فیلدها
buttons[]

object ( Button )

مجموعه ای از دکمه ها

TextInput

فیلدی که کاربران می توانند متن را در آن وارد کنند. از پیشنهادات و اقدامات در حال تغییر پشتیبانی می کند. از تأیید صحت ارسال فرم پشتیبانی می کند. وقتی Action.all_widgets_are_required روی true تنظیم شود یا این ویجت در Action.required_widgets مشخص شده باشد، اقدام ارسال مسدود می شود مگر اینکه مقداری وارد شود. برای مثال در برنامه‌های گپ Google، به افزودن فیلدی که کاربر می‌تواند متن را در آن وارد کند، مراجعه کنید.

برنامه‌های چت مقدار متن وارد شده را در طول رویدادهای ورودی فرم دریافت می‌کنند و می‌توانند آن را پردازش کنند. برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

هنگامی که نیاز به جمع آوری داده های تعریف نشده یا انتزاعی از کاربران دارید، از ورودی متن استفاده کنید. برای جمع آوری داده های تعریف شده یا شمارش شده از کاربران، از ویجت SelectionInput استفاده کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string
}
فیلدها
name

string

نامی که با آن ورودی متن در رویداد ورودی فرم مشخص می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

label

string

متنی که در بالای فیلد ورودی متن در رابط کاربری ظاهر می شود.

متنی را مشخص کنید که به کاربر کمک کند اطلاعات مورد نیاز برنامه شما را وارد کند. برای مثال، اگر نام شخصی را می‌پرسید، اما به طور خاص به نام خانوادگی او نیاز دارید، به جای name surname بنویسید.

اگر hintText نامشخص باشد، لازم است. در غیر این صورت اختیاری است.

hint Text

string

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

اگر label نامشخص باشد، الزامی است. در غیر این صورت اختیاری است.

value

string

مقدار وارد شده توسط کاربر، به عنوان بخشی از یک رویداد ورودی فرم برگردانده می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

type

enum ( Type )

نحوه نمایش فیلد ورودی متن در رابط کاربری مثلاً فیلد تک خطی باشد یا چند خطی.

on Change Action

object ( Action )

وقتی تغییری در قسمت ورودی متن رخ می دهد چه باید کرد. به عنوان مثال، کاربر در حال افزودن به فیلد یا حذف متن.

نمونه‌هایی از اقداماتی که باید انجام دهید شامل اجرای یک عملکرد سفارشی یا باز کردن یک گفتگو در چت Google است.

initial Suggestions

object ( Suggestions )

مقادیر پیشنهادی که کاربران می توانند وارد کنند. این مقادیر زمانی ظاهر می شوند که کاربران داخل فیلد ورودی متن کلیک می کنند. همانطور که کاربران تایپ می کنند، مقادیر پیشنهادی به صورت پویا فیلتر می شوند تا با آنچه کاربران تایپ کرده اند مطابقت داشته باشد.

به عنوان مثال، یک فیلد ورودی متن برای زبان برنامه نویسی ممکن است جاوا، جاوا اسکریپت، پایتون و C++ را پیشنهاد کند. هنگامی که کاربران شروع به تایپ Jav می کنند، لیست پیشنهادات برای نشان دادن Java و JavaScript فیلتر می شود.

مقادیر پیشنهادی به کاربران کمک می‌کند تا مقادیری را وارد کنند که برنامه شما می‌تواند از آنها استفاده کند. هنگام مراجعه به جاوا اسکریپت، برخی از کاربران ممکن است javascript و برخی دیگر java script وارد کنند. پیشنهاد JavaScript می تواند نحوه تعامل کاربران با برنامه شما را استاندارد کند.

وقتی مشخص شد، TextInput.type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

auto Complete Action

object ( Action )

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

اگر مشخص نشده باشد، پیشنهادات توسط initialSuggestions تنظیم می شوند و توسط مشتری پردازش می شوند.

اگر مشخص شده باشد، برنامه عملکرد مشخص شده در اینجا را انجام می دهد، مانند اجرای یک تابع سفارشی.

برای افزونه‌های Google Workspace موجود است و برای برنامه‌های Google Chat در دسترس نیست.

validation

object ( Validation )

اعتبار فرمت ورودی لازم برای این فیلد متنی را مشخص کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

placeholder Text

string

متنی که وقتی فیلد خالی است در قسمت ورودی متن ظاهر می شود. از این متن برای درخواست از کاربران برای وارد کردن یک مقدار استفاده کنید. به عنوان مثال، Enter a number from 0 to 100 .

برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

تایپ کنید

نحوه نمایش فیلد ورودی متن در رابط کاربری برای مثال، چه یک فیلد ورودی تک خطی باشد یا یک ورودی چند خطی. اگر initialSuggestions مشخص شده باشد، type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

Enums
SINGLE_LINE فیلد ورودی متن دارای ارتفاع ثابت یک خط است.
MULTIPLE_LINE فیلد ورودی متن دارای ارتفاع ثابتی از چندین خط است.

RenderActions

مجموعه‌ای از دستورالعمل‌های رندر که به کارت می‌گوید یک عملکرد را انجام دهد، یا به برنامه میزبان افزودنی یا برنامه چت می‌گوید که یک عملکرد خاص برنامه را انجام دهد.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

فیلدها
action

Action

اقدام

فیلدها
navigations[]

Navigation

یک کارت را فشار می دهد، بیرون می آورد یا به روز می کند.

پیش‌نمایش توسعه‌دهنده : افزونه‌ها در چت Google .

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

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است. 

navigations: {
  pushCard: CARD
}

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

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است. 

navigations: {
  updateCard: CARD
}

پیشنهادات

مقادیر پیشنهادی که کاربران می توانند وارد کنند. این مقادیر زمانی ظاهر می شوند که کاربران داخل فیلد ورودی متن کلیک می کنند. همانطور که کاربران تایپ می کنند، مقادیر پیشنهادی به صورت پویا فیلتر می شوند تا با آنچه کاربران تایپ کرده اند مطابقت داشته باشد.

به عنوان مثال، یک فیلد ورودی متن برای زبان برنامه نویسی ممکن است جاوا، جاوا اسکریپت، پایتون و C++ را پیشنهاد کند. هنگامی که کاربران شروع به تایپ Jav می کنند، لیست پیشنهادات برای نمایش Java و JavaScript فیلتر می شود.

مقادیر پیشنهادی به کاربران کمک می‌کند تا مقادیری را وارد کنند که برنامه شما می‌تواند از آنها استفاده کند. هنگام مراجعه به جاوا اسکریپت، برخی از کاربران ممکن است javascript و برخی دیگر java script وارد کنند. پیشنهاد JavaScript می تواند نحوه تعامل کاربران با برنامه شما را استاندارد کند.

وقتی مشخص شد، TextInput.type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
فیلدها
items[]

object ( SuggestionItem )

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

آیتم پیشنهادی

یک مقدار پیشنهادی که کاربران می توانند در قسمت ورودی متن وارد کنند.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}
فیلدها

content زمینه اتحادیه

content فقط می تواند یکی از موارد زیر باشد:

text

string

مقدار یک ورودی پیشنهادی برای یک فیلد ورودی متن. این معادل چیزی است که کاربران خودشان وارد می کنند.

اعتبار سنجی

نشان دهنده داده های لازم برای اعتبارسنجی ویجتی است که به آن پیوست شده است.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نمایندگی JSON 
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
فیلدها
character Limit

integer

محدودیت کاراکتر را برای ویجت های ورودی متن مشخص کنید. توجه داشته باشید که این فقط برای ورودی متن استفاده می شود و برای سایر ویجت ها نادیده گرفته می شود.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

input Type

enum ( InputType )

نوع ویجت های ورودی را مشخص کنید.

برای برنامه‌های Google Chat و افزونه‌های Google Workspace موجود است.

نوع ورودی

نوع ویجت ورودی

Enums
INPUT_TYPE_UNSPECIFIED نوع نامشخص استفاده نکنید.
TEXT متن منظم که همه شخصیت ها را می پذیرد.
INTEGER یک مقدار صحیح
FLOAT یک مقدار شناور
EMAIL یک آدرس ایمیل
EMOJI_PICKER ایموجی انتخاب شده از انتخاب کننده ایموجی با سیستم.

انتخاب

ویجت که یک یا چند مورد UI را ایجاد می کند که کاربران می توانند انتخاب کنند. پشتیبانی از اعتبار ارسال فرم فقط برای منوهای dropdown و multiselect . هنگامی که Action.all_widgets_are_required روی true تنظیم شده است یا این ویجت در عمل مشخص شده است. Action.required_widgets ، عمل ارسال مسدود می شود مگر اینکه مقدار انتخاب شود. به عنوان مثال ، منوی کشویی یا کادر انتخاب. می توانید از این ویجت برای جمع آوری داده هایی که می توان پیش بینی یا شمارش کرد ، استفاده کنید. برای مثال در برنامه های Google Chat ، به عناصر UI قابل انتخاب مراجعه کنید.

برنامه های گپ می توانند ارزش مواردی را که کاربران انتخاب یا ورودی می کنند پردازش کنند. برای جزئیات بیشتر در مورد کار با ورودی های فرم ، به دریافت داده های فرم مراجعه کنید.

برای جمع آوری داده های نامشخص یا انتزاعی از کاربران ، از ویجت TextInput استفاده کنید.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMaxSelectedItems": integer,
  "multiSelectMinQueryLength": integer,

  // Union field multi_select_data_source can be only one of the following:
  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  // End of list of possible types for union field multi_select_data_source.
}
فیلدها
name

string

مورد نیاز. نامی که ورودی انتخاب را در یک رویداد ورودی فرم مشخص می کند.

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

label

string

متنی که در بالای قسمت ورودی ورودی در رابط کاربری ظاهر می شود.

متنی را مشخص کنید که به کاربر کمک می کند تا اطلاعاتی را که برنامه شما نیاز دارد وارد کند. به عنوان مثال ، اگر کاربران در حال انتخاب فوریت بلیط کار از منوی کشویی هستند ، ممکن است برچسب "فوریت" یا "فوریت انتخاب" باشد.

type

enum ( SelectionType )

نوع مواردی که در یک ویجت SelectionInput به کاربران نمایش داده می شود. انواع انتخاب از انواع مختلف تعامل پشتیبانی می کند. به عنوان مثال ، کاربران می توانند یک یا چند کادر انتخاب را انتخاب کنند ، اما فقط می توانند یک مقدار را از منوی کشویی انتخاب کنند.

items[]

object ( SelectionItem )

مجموعه ای از موارد قابل انتخاب. به عنوان مثال ، مجموعه ای از دکمه های رادیویی یا کادر انتخاب. حداکثر 100 مورد را پشتیبانی می کند.

on Change Action

object ( Action )

در صورت مشخص شدن ، فرم هنگام تغییر انتخاب ارسال می شود. اگر مشخص نشده باشد ، باید یک دکمه جداگانه را ارسال کنید که فرم را ارسال کند.

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

multi Select Max Selected Items

integer

برای منوهای چند منتخب ، حداکثر تعداد مواردی که کاربر می تواند انتخاب کند. حداقل مقدار 1 مورد است. اگر نامشخص باشد ، به 3 مورد پیش فرض کنید.

multi Select Min Query Length

integer

برای منوهای چند منتخب ، تعداد کاراکترهای متنی که یک کاربر قبل از بازگشت منو وارد می کند موارد انتخابی را پیشنهاد می کند.

در صورت عدم استفاده ، منوی Multiselect از مقادیر پیش فرض زیر استفاده می کند:

  • اگر این منو از یک آرایه استاتیک از موارد SelectionInput استفاده می کند ، به طور پیش فرض به 0 کاراکتر و بلافاصله موارد را از آرایه جمع می کند.
  • اگر این منو از یک منبع داده پویا ( multi_select_data_source ) استفاده می کند ، قبل از پرس و جو از منبع داده برای بازگشت موارد پیشنهادی به 3 کاراکتر پیش فرض می شود.

Union Field multi_select_data_source . برای یک منوی چند منتخب ، یک منبع داده که به طور پویا موارد انتخاب را جمع می کند.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست. multi_select_data_source تنها می تواند یکی از موارد زیر باشد:

external Data Source

object ( Action )

یک منبع داده خارجی ، مانند یک پایگاه داده رابطه ای.

platform Data Source

object ( PlatformDataSource )

یک منبع داده از فضای کاری Google.

SelectionType

قالب برای مواردی که کاربران می توانند انتخاب کنند. گزینه های مختلف از انواع مختلف تعامل پشتیبانی می کنند. به عنوان مثال ، کاربران می توانند چندین کادر انتخاب را انتخاب کنند ، اما فقط می توانند یک مورد را از منوی کشویی انتخاب کنند.

هر ورودی انتخاب از یک نوع انتخاب پشتیبانی می کند. به عنوان مثال ، مخلوط کردن کادر و سوئیچ ها پشتیبانی نمی شود.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
CHECK_BOX مجموعه ای از کادر چک. کاربران می توانند یک یا چند کادر انتخاب را انتخاب کنند.
RADIO_BUTTON مجموعه ای از دکمه های رادیویی. کاربران می توانند یک دکمه رادیویی را انتخاب کنند.
SWITCH مجموعه ای از سوئیچ ها. کاربران می توانند یک یا چند سوئیچ را روشن کنند.
DROPDOWN منوی کشویی. کاربران می توانند یک مورد را از منو انتخاب کنند.
MULTI_SELECT

منویی با جعبه متن. کاربران می توانند یک یا چند مورد را تایپ و انتخاب کنند. برای افزودنیهای فضای کاری Google ، شما باید موارد را با استفاده از یک آرایه استاتیک از اشیاء SelectionItem جمع کنید.

برای برنامه های Google Chat ، می توانید موارد را با استفاده از یک منبع داده پویا و موارد خودکار Autosuggest جمع کنید زیرا کاربران در منو تایپ می کنند. به عنوان مثال ، کاربران می توانند شروع به تایپ نام فضای گپ Google و ویجت Autosuguggest فضا کنند. برای جمع آوری پویا برای منوی چند انتخابی ، از یکی از انواع زیر منابع داده استفاده کنید:

  • Google WorksPace Data: موارد با استفاده از داده های فضای کاری Google ، مانند کاربران Google Workspace یا فضای Google Chat ، جمع می شوند.
  • داده های خارجی: موارد از یک منبع داده خارجی در خارج از فضای کاری Google جمع می شوند.

برای نمونه هایی از نحوه اجرای منوهای چند منتخب برای برنامه های گپ ، به یک منوی چند منتخب اضافه کنید .

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

انتخاب

موردی که کاربران می توانند در یک ورودی انتخاب ، مانند کادر انتخاب یا سوئیچ انتخاب کنند. حداکثر 100 مورد را پشتیبانی می کند.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "text": string,
  "value": string,
  "selected": boolean,
  "startIconUri": string,
  "bottomText": string
}
فیلدها
text

string

متنی که مورد را برای کاربران مشخص یا توصیف می کند.

value

string

مقدار مرتبط با این مورد. مشتری باید از این به عنوان مقدار ورودی فرم استفاده کند.

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

selected

boolean

آیا مورد به طور پیش فرض انتخاب شده است. اگر ورودی انتخاب فقط یک مقدار را می پذیرد (مانند دکمه های رادیویی یا منوی کشویی) ، فقط این قسمت را برای یک مورد تنظیم کنید.

start Icon Uri

string

برای منوهای چند منتخب ، URL برای نماد نمایش داده شده در کنار قسمت text مورد. از پرونده های PNG و JPEG پشتیبانی می کند. باید یک URL HTTPS باشد. به عنوان مثال ، https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png .

bottom Text

string

برای منوهای چندگانه ، توضیحات متن یا برچسب که در زیر قسمت text مورد نمایش داده می شود.

PlatformDatasource

برای یک ویجت SelectionInput که از یک منوی چند منتخب ، یک منبع داده از فضای کاری Google استفاده می کند. برای جمع آوری موارد در یک منوی چند منتخب استفاده می شود.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{

  // Union field data_source can be only one of the following:
  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}
فیلدها
Union Field data_source . منبع داده data_source فقط می تواند یکی از موارد زیر باشد:
common Data Source

enum ( CommonDataSource )

یک منبع داده به اشتراک گذاشته شده توسط کلیه برنامه های فضای کاری Google ، مانند کاربران در یک سازمان فضای کاری Google.

host App Data Source

object ( HostAppDataSourceMarkup )

منبع داده ای که منحصر به یک برنامه میزبان فضای کاری Google است ، چنین فضاهایی در Google Chat.

این زمینه از کتابخانه های مشتری Google API پشتیبانی می کند اما در کتابخانه های مشتری Cloud در دسترس نیست. برای کسب اطلاعات بیشتر ، به نصب کتابخانه های مشتری مراجعه کنید.

CommonDataSource

یک منبع داده به اشتراک گذاشته شده توسط همه برنامه های فضای کاری Google .

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

Enums
UNKNOWN مقدار پیش فرض استفاده نکنید.
USER کاربران فضای کاری Google. کاربر فقط می تواند کاربران را از سازمان فضای کاری Google خود مشاهده و انتخاب کند.

HostappDatasourCemarkup

برای یک ویجت SelectionInput که از یک منوی چند منتخب استفاده می کند ، یک منبع داده از یک برنامه فضای کاری Google است. منبع داده موارد انتخاب را برای منوی چند انتخابی جمع می کند.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{

  // Union field data_source can be only one of the following:
  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  }
  // End of list of possible types for union field data_source.
}
فیلدها
Union Field data_source . برنامه فضای کاری Google که مواردی را برای منوی چند انتخابی جمع می کند. data_source فقط می تواند یکی از موارد زیر باشد:
chat Data Source

object ( ChatClientDataSourceMarkup )

یک منبع داده از Google Chat.

chatclientdatasourcemarkup

برای یک ویجت SelectionInput که از منوی چند انتخابی استفاده می کند ، یک منبع داده از Google Chat است. منبع داده موارد انتخاب را برای منوی چند انتخابی جمع می کند. به عنوان مثال ، یک کاربر می تواند فضاهای چت Google را که عضو آن هستند ، انتخاب کند.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{

  // Union field source can be only one of the following:
  "spaceDataSource": {
    object (SpaceDataSource)
  }
  // End of list of possible types for union field source.
}
فیلدها
source میدانی اتحادیه. منبع داده چت Google. source می تواند تنها یکی از موارد زیر باشد:
space Data Source

object ( SpaceDataSource )

فضاهای گپ گوگل که کاربر عضو آن است.

فاصله

منبع داده ای که فضاهای گپ Google را به عنوان موارد انتخابی برای یک منوی چند انتخابی جمع می کند. فقط فضاهایی را جمع می کند که کاربر عضو آن است.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{
  "defaultToCurrentSpace": boolean
}
فیلدها
default To Current Space

boolean

اگر روی true تنظیم شود ، منوی Multiselect فضای فعلی چت Google را به طور پیش فرض به عنوان یک مورد انتخاب می کند.

DateTimePicker

به کاربران اجازه می دهد تاریخ ، یک زمان یا هر دو تاریخ و زمان را وارد کنند. از اعتبار سنجی ارسال فرم پشتیبانی می کند. هنگامی که Action.all_widgets_are_required روی true تنظیم شده است یا این ویجت در عمل مشخص شده است. Action.required_widgets ، عمل ارسال مسدود می شود مگر اینکه مقدار انتخاب شود. برای مثال در برنامه های Google Chat ، به کاربر اجازه دهید تاریخ و زمان را انتخاب کند .

کاربران می توانند متن را وارد کنند یا از انتخاب کننده برای انتخاب تاریخ و زمان استفاده کنند. اگر کاربران یک تاریخ یا زمان نامعتبر وارد کنند ، انتخاب کننده خطایی را نشان می دهد که کاربران را به درستی وارد می کند.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
فیلدها
name

string

نامی که DateTimePicker در یک رویداد ورودی فرم مشخص می شود.

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

label

string

متنی که کاربران را ترغیب می کند تا تاریخ ، زمان یا تاریخ و زمان را وارد کنند. به عنوان مثال ، اگر کاربران در حال برنامه ریزی قرار ملاقات هستند ، از برچسب مانند Appointment date یا Appointment date and time استفاده کنید.

type

enum ( DateTimePickerType )

آیا ویجت از ورود تاریخ ، زمان یا تاریخ و زمان پشتیبانی می کند.

value Ms Epoch

string ( int64 format)

مقدار پیش فرض نمایش داده شده در ویجت ، در میلی ثانیه از زمان دوره یونیکس .

مقدار را بر اساس نوع انتخاب کننده ( DateTimePickerType ) مشخص کنید:

  • DATE_AND_TIME : تاریخ و زمان تقویم در UTC. به عنوان مثال ، برای نمایندگی از اول ژانویه 2023 ساعت 12:00 بعد از ظهر UTC ، از 1672574400000 استفاده کنید.
  • DATE_ONLY : تاریخ تقویم ساعت 00:00:00 UTC. به عنوان مثال ، برای نشان دادن 1 ژانویه 2023 ، از 1672531200000 استفاده کنید.
  • TIME_ONLY : زمان در UTC. به عنوان مثال ، برای نمایندگی 12:00 بعد از ظهر ، از 43200000 (یا 12 * 60 * 60 * 1000 ) استفاده کنید.
timezone Offset Date

integer

تعداد نمایندگی منطقه زمانی جبران شده از UTC ، در عرض چند دقیقه. در صورت تنظیم ، valueMsEpoch در منطقه زمانی مشخص شده نمایش داده می شود. در صورت عدم استفاده ، مقدار پیش فرض تنظیم منطقه زمانی کاربر است.

on Change Action

object ( Action )

هنگامی که کاربر کلیک می کند از رابط DateTimePicker کلیک می کند یا پاک می شود .

dateTimePickertype

قالب تاریخ و زمان در ویجت DateTimePicker . تعیین می کند که آیا کاربران می توانند تاریخ ، یک زمان یا هر دو تاریخ و زمان را وارد کنند.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
DATE_AND_TIME کاربران تاریخ و زمان را وارد می کنند.
DATE_ONLY کاربران یک تاریخ را وارد می کنند.
TIME_ONLY کاربران یک زمان را وارد می کنند.

تقسیم کننده

این نوع فیلدهایی ندارد.

تقسیم کننده بین ابزارک ها به عنوان یک خط افقی را نشان می دهد. برای مثال در برنامه های Google Chat ، به یک تقسیم افقی بین ابزارک ها اضافه کنید .

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

به عنوان مثال ، JSON زیر یک تقسیم کننده ایجاد می کند: 

"divider": {}

شبکه

یک شبکه با مجموعه ای از موارد را نشان می دهد. موارد فقط می توانند شامل متن یا تصاویر باشند. برای ستون های پاسخگو ، یا شامل بیش از متن یا تصاویر ، Columns استفاده کنید. برای مثال در برنامه های Google Chat ، به نمایش یک شبکه با مجموعه ای از موارد مراجعه کنید.

یک شبکه از هر تعداد ستون و موارد پشتیبانی می کند. تعداد ردیف ها توسط موارد تقسیم شده توسط ستون ها تعیین می شود. یک شبکه با 10 مورد و 2 ستون دارای 5 ردیف است. یک شبکه با 11 مورد و 2 ستون دارای 6 ردیف است.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

به عنوان مثال ، JSON زیر یک شبکه 2 ستون با یک مورد واحد ایجاد می کند: 

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
نمایندگی JSON 
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
فیلدها
title

string

متنی که در هدر شبکه نمایش داده می شود.

items[]

object ( GridItem )

مواردی که در شبکه نمایش داده می شود.

border Style

object ( BorderStyle )

سبک مرزی برای استفاده از هر مورد شبکه.

column Count

integer

تعداد ستون ها برای نمایش در شبکه. اگر این قسمت مشخص نشده باشد ، از مقدار پیش فرض استفاده می شود و بسته به جایی که شبکه نشان داده شده است (گفتگوی در مقابل همراه) ، مقدار پیش فرض متفاوت است.

on Click

object ( OnClick )

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

شبکه

یک مورد را در یک طرح شبکه نشان می دهد. موارد می توانند حاوی متن ، یک تصویر ، یا متن و یک تصویر باشند.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
فیلدها
id

string

شناسه مشخص شده توسط کاربر برای این مورد شبکه. این شناسه در پارامترهای پاسخگویی onClick شبکه والدین بازگردانده می شود.

image

object ( ImageComponent )

تصویری که در مورد شبکه نمایش داده می شود.

title

string

عنوان مورد شبکه.

subtitle

string

زیرنویس مورد شبکه.

layout

enum ( GridItemLayout )

طرح برای استفاده برای مورد شبکه.

تصویر

یک تصویر را نشان می دهد.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
فیلدها
image Uri

string

آدرس تصویر.

alt Text

string

برچسب دسترسی برای تصویر.

crop Style

object ( ImageCropStyle )

سبک محصول برای استفاده از تصویر.

border Style

object ( BorderStyle )

سبک مرزی برای اعمال روی تصویر.

سبک تصویر

نشان دهنده سبک محصول اعمال شده بر روی یک تصویر است.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

به عنوان مثال ، در اینجا نحوه استفاده از نسبت ابعاد 16: 9 آورده شده است: 

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
نمایندگی JSON 
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
فیلدها
type

enum ( ImageCropType )

نوع محصول

aspect Ratio

number

نسبت ابعاد در صورت استفاده از نوع محصول RECTANGLE_CUSTOM است.

به عنوان مثال ، در اینجا نحوه استفاده از نسبت ابعاد 16: 9 آورده شده است: 

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

نوع تصویربرداری

نشان دهنده سبک محصول اعمال شده بر روی یک تصویر است.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
IMAGE_CROP_TYPE_UNSPECIFIED استفاده نکنید. نامشخص
SQUARE مقدار پیش فرض یک محصول مربع را اعمال می کند.
CIRCLE یک محصول دایره ای را اعمال می کند.
RECTANGLE_CUSTOM یک محصول مستطیل شکل با نسبت ابعاد سفارشی اعمال می شود. نسبت ابعاد سفارشی را با aspectRatio تنظیم کنید.
RECTANGLE_4_3 یک محصول مستطیل شکل با نسبت ابعاد 4: 3 اعمال می شود.

سبک مرزی

گزینه های سبک برای مرز کارت یا ویجت ، از جمله نوع و رنگ مرزی.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
فیلدها
type

enum ( BorderType )

نوع مرزی

stroke Color

object ( Color )

رنگ هایی که باید در هنگام استفاده از نوع BORDER_TYPE_STROKE استفاده شود.

برای تنظیم رنگ سکته مغزی ، مقداری را برای زمینه های red ، green و blue مشخص کنید. مقدار باید یک عدد شناور بین 0 و 1 بر اساس مقدار رنگ RGB باشد ، جایی که 0 (0/255) نشان دهنده عدم وجود رنگ است و 1 (255/255) حداکثر شدت رنگ را نشان می دهد.

به عنوان مثال ، زیر رنگ را با حداکثر شدت خود به رنگ قرمز تنظیم می کند: 

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

میدان alpha برای رنگ سکته مغزی در دسترس نیست. در صورت مشخص شدن ، این زمینه نادیده گرفته می شود.

corner Radius

integer

شعاع گوشه ای برای مرز.

نوع مرزی

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

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
BORDER_TYPE_UNSPECIFIED استفاده نکنید. نامشخص
NO_BORDER مقدار پیش فرض بدون مرز
STROKE طرح کلی.

رفیق

گزینه های مختلف طرح بندی موجود برای یک مورد شبکه را نشان می دهد.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
GRID_ITEM_LAYOUT_UNSPECIFIED استفاده نکنید. نامشخص
TEXT_BELOW عنوان و زیرنویس در زیر تصویر مورد شبکه نشان داده شده است.
TEXT_ABOVE عنوان و زیرنویس در بالای تصویر مورد شبکه نشان داده شده است.

ستون ها

ویجت Columns حداکثر 2 ستون در کارت یا گفتگو نشان می دهد. می توانید ویجت ها را به هر ستون اضافه کنید. ابزارک ها به ترتیب مشخص شده ظاهر می شوند. برای مثال در برنامه های گپ Google ، به کارتهای نمایش و گفتگوها در ستون ها مراجعه کنید.

ارتفاع هر ستون توسط ستون بلندتر تعیین می شود. به عنوان مثال ، اگر ستون اول از ستون دوم بلندتر باشد ، هر دو ستون از ارتفاع ستون اول برخوردار هستند. از آنجا که هر ستون می تواند تعداد متفاوتی از ویجت ها را داشته باشد ، شما نمی توانید ردیف ها یا ابزارک های تراز بین ستون ها را تعریف کنید.

ستون ها در کنار هم نمایش داده می شوند. می توانید عرض هر ستون را با استفاده از قسمت HorizontalSizeStyle سفارشی کنید. اگر عرض صفحه کاربر خیلی باریک باشد ، ستون دوم زیر اول است:

  • در وب ، ستون دوم اگر عرض صفحه نمایش کمتر از 480 پیکسل باشد ، بسته می شود.
  • در دستگاه های iOS ، ستون دوم اگر عرض صفحه نمایش کمتر از یا مساوی 300 pt باشد ، بسته می شود.
  • در دستگاه های Android ، ستون دوم اگر عرض صفحه نمایش کمتر از یا مساوی 320 DP باشد ، بسته می شود.

برای شامل بیش از دو ستون یا استفاده از ردیف ها ، از ویجت Grid استفاده کنید.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است. UI های افزودنی که ستون های پشتیبانی را پشتیبانی می کنند شامل موارد زیر است:

  • گفتگوی نمایش داده می شود وقتی کاربران افزونه را از یک پیش نویس ایمیل باز می کنند.
  • گفتگوی نمایش داده می شود وقتی کاربران در یک رویداد تقویم Google افزودنی را از منوی Add Attachment باز می کنند.
نمایندگی JSON 
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
فیلدها
column Items[]

object ( Column )

مجموعه ای از ستون ها. می توانید حداکثر 2 ستون را در کارت یا گفتگو قرار دهید.

ستون

یک ستون

افزودنی های فضای کاری Google و برنامه های چت

نمایندگی JSON 
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
فیلدها
horizontal Size Style

enum ( HorizontalSizeStyle )

مشخص می کند که چگونه یک ستون عرض کارت را پر می کند.

horizontal Alignment

enum ( HorizontalAlignment )

مشخص می کند که ویجت ها به سمت چپ ، راست یا مرکز یک ستون تراز می شوند.

vertical Alignment

enum ( VerticalAlignment )

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

widgets[]

object ( Widgets )

مجموعه ای از ابزارک های موجود در یک ستون. ابزارک ها به ترتیب مشخص شده ظاهر می شوند.

سبک افقی

مشخص می کند که چگونه یک ستون عرض کارت را پر می کند. عرض هر ستون به هر دو HorizontalSizeStyle و عرض ویجت ها در ستون بستگی دارد.

افزودنی های فضای کاری Google و برنامه های چت

Enums
HORIZONTAL_SIZE_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
FILL_AVAILABLE_SPACE مقدار پیش فرض ستون فضای موجود را تا 70 ٪ از عرض کارت پر می کند. اگر هر دو ستون روی FILL_AVAILABLE_SPACE تنظیم شده باشند ، هر ستون 50 ٪ از فضا را پر می کند.
FILL_MINIMUM_SPACE ستون کمترین فضای ممکن را پر می کند و بیش از 30 ٪ از عرض کارت نیست.

تراز افقی

مشخص می کند که ویجت ها به سمت چپ ، راست یا مرکز یک ستون تراز می شوند.

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

Enums
HORIZONTAL_ALIGNMENT_UNSPECIFIED استفاده نکنید. نامشخص
START مقدار پیش فرض ابزارک ها را به موقعیت شروع ستون تراز می کند. برای چیدمان های چپ به راست ، تراز در سمت چپ. برای چیدمان های راست به چپ ، به سمت راست تراز کنید.
CENTER ابزارک ها را به مرکز ستون تراز می کند.
END ابزارک ها را به موقعیت انتهایی ستون تراز می کند. برای طرح های چپ به راست ، ابزارک ها را به سمت راست تراز می کند. برای طرح های راست به چپ ، ابزارک های سمت چپ را تراز می کند.

تغییر شکل

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

افزودنی های فضای کاری Google و برنامه های چت

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED استفاده نکنید. نامشخص
CENTER مقدار پیش فرض ویجت ها را به مرکز یک ستون تراز می کند.
TOP ابزارک ها را به بالای ستون تراز می کند.
BOTTOM ابزارک ها را به پایین یک ستون تراز می کند.

ابزارک ها

ابزارک های پشتیبانی شده که می توانید در یک ستون قرار دهید.

افزودنی های فضای کاری Google و برنامه های چت

نمایندگی JSON 
{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
  // End of list of possible types for union field data.
}
فیلدها

data میدانی اتحادیه.

data فقط می توانند یکی از موارد زیر باشند:

text Paragraph

object ( TextParagraph )

ویجت TextParagraph .

image

object ( Image )

ویجت Image .

decorated Text

object ( DecoratedText )

ویجت DecoratedText .

button List

object ( ButtonList )

ویجت ButtonList .

text Input

object ( TextInput )

ویجت TextInput .

selection Input

object ( SelectionInput )

ویجت SelectionInput .

date Time Picker

object ( DateTimePicker )

ویجت DateTimePicker .

chip List

object ( ChipList )

ویجت ChipList .

ChipList

لیستی از تراشه ها به صورت افقی مشخص شده است ، که می تواند به صورت افقی پیمایش کند یا به خط بعدی بپیچد.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
فیلدها
layout

enum ( Layout )

چیدمان لیست تراشه مشخص شده.

chips[]

object ( Chip )

مجموعه ای از تراشه ها.

طرح بندی

طرح لیست تراشه.

Enums
LAYOUT_UNSPECIFIED استفاده نکنید. نامشخص
WRAPPED مقدار پیش فرض اگر فضای افقی کافی وجود نداشته باشد ، لیست تراشه ها به خط بعدی می پردازند.
HORIZONTAL_SCROLLABLE اگر در فضای موجود قرار نگیرد ، تراشه ها به صورت افقی پیمایش می کنند.

تراشه

متن ، نماد یا متن و تراشه آیکون که کاربران می توانند آن را کلیک کنند.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
فیلدها
icon

object ( Icon )

تصویر نماد اگر هر دو icon و text تنظیم شوند ، آنگاه قبل از متن ظاهر می شود.

label

string

متن نمایش داده شده در داخل تراشه.

on Click

object ( OnClick )

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

enabled
(deprecated)

boolean

این که آیا تراشه در حالت فعال قرار دارد و به اقدامات کاربر پاسخ می دهد. پیش فرض ها به true منسوخ شده است. به جای آن از disabled استفاده کنید.

disabled

boolean

این که آیا تراشه در حالت غیرفعال قرار دارد و اقدامات کاربر را نادیده می گیرد. پیش فرض ها به false .

alt Text

string

متن جایگزین که برای دسترسی استفاده می شود.

متن توصیفی را تنظیم کنید که به کاربران اجازه می دهد تا بدانند که تراشه چه کاری انجام می دهد. به عنوان مثال ، اگر یک تراشه یک لینک لینک را باز می کند ، بنویسید: "یک برگه مرورگر جدید را باز می کند و به اسناد توسعه دهنده Google Chat در https://developers.google.com/workspace/chat" حرکت می کند.

یک چرخ فلک ، که به عنوان کشویی نیز شناخته می شود ، لیستی از ویجت ها را با فرمت نمایش اسلاید می چرخاند و نشان می دهد ، و دکمه های مربوط به ویجت قبلی یا بعدی هستند.

به عنوان مثال ، این یک نمایش JSON از یک چرخ فلک است که شامل سه ابزارک پاراگراف متن است. 

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{
  "carouselCards": [
    {
      object (CarouselCard)
    }
  ]
}
فیلدها
carousel Cards[]

object ( CarouselCard )

لیستی از کارتهای موجود در چرخ فلک.

چرخ فلک

کارتی که می تواند به عنوان یک کالای چرخ فلک نمایش داده شود. برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
فیلدها
widgets[]

object ( NestedWidget )

لیستی از ابزارک های نمایش داده شده در کارت چرخ فلک. ابزارک ها به ترتیب مشخص شده نمایش داده می شوند.

footer Widgets[]

object ( NestedWidget )

لیستی از ابزارک های نمایش داده شده در پایین کارت چرخ فلک. ابزارک ها به ترتیب مشخص شده نمایش داده می شوند.

پهنه

لیستی از ابزارک هایی که می توانند در یک طرح حاوی مانند CarouselCard نشان داده شوند. برای برنامه های Google CHAT در دسترس است و برای افزودنیهای فضای کاری Google در دسترس نیست.

نمایندگی JSON 
{

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
  // End of list of possible types for union field data.
}
فیلدها

data میدانی اتحادیه.

data فقط می توانند یکی از موارد زیر باشند:

text Paragraph

object ( TextParagraph )

ویجت پاراگراف متن.

button List

object ( ButtonList )

ویجت لیست دکمه.

image

object ( Image )

ویجت تصویر.

کنترل کننده

نمایانگر یک کنترل گسترش و فروپاشی است.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
فیلدها
horizontal Alignment

enum ( HorizontalAlignment )

تراز افقی دکمه گسترش و فروپاشی.

expand Button

object ( Button )

اختیاری. یک دکمه قابل تنظیم را برای گسترش بخش تعریف کنید. هر دو ExpandButton و CollapseButton باید تنظیم شوند. فقط یک مجموعه زمینه به مرحله اجرا در نمی آید. اگر این قسمت تنظیم نشده باشد ، از دکمه پیش فرض استفاده می شود.

collapse Button

object ( Button )

اختیاری. یک دکمه قابل تنظیم را برای فروپاشی بخش تعریف کنید. هر دو ExpandButton و CollapseButton باید تنظیم شوند. فقط یک مجموعه زمینه به مرحله اجرا در نمی آید. اگر این قسمت تنظیم نشده باشد ، از دکمه پیش فرض استفاده می شود.

تقسیم تقسیم

سبک تقسیم کننده کارت. در حال حاضر فقط برای تقسیم بخش های کارت استفاده می شود.

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

Enums
DIVIDER_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
SOLID_DIVIDER گزینه پیش فرض یک تقسیم کننده محکم ارائه دهید.
NO_DIVIDER در صورت تنظیم ، هیچ تقسیم کننده ارائه نمی شود. این سبک تقسیم کننده را کاملاً از طرح خارج می کند. نتیجه معادل اضافه نکردن یک تقسیم کننده است.

کاردستی

اقدام کارت عمل مرتبط با کارت است. به عنوان مثال ، یک کارت فاکتور ممکن است شامل اقداماتی مانند حذف فاکتور ، فاکتور ایمیل یا باز کردن فاکتور در یک مرورگر باشد.

در دسترس برای افزودنی های فضای کاری Google و برای برنامه های Google Chat در دسترس نیست.

نمایندگی JSON 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
فیلدها
action Label

string

برچسب که به عنوان مورد منوی اکشن نمایش داده می شود.

on Click

object ( OnClick )

عمل onClick برای این مورد اقدام.

پوتین

یک پاورقی مداوم (چسبناک) که در پایین کارت ظاهر می شود.

تنظیم fixedFooter بدون مشخص کردن یک primaryButton یا secondaryButton باعث ایجاد خطایی می شود.

برای برنامه های چت ، می توانید از پاورقی های ثابت در گفتگوها استفاده کنید ، اما پیام های کارت نیست. به عنوان مثال در برنامه های گپ Google ، به یک پایدار پایدار اضافه کنید .

برای برنامه های Google CHAT و افزودنی های فضای کاری Google در دسترس است.

نمایندگی JSON 
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
فیلدها
primary Button

object ( Button )

دکمه اصلی پاورقی ثابت. دکمه باید یک دکمه متن با متن و تنظیم رنگ باشد.

secondary Button

object ( Button )

دکمه ثانویه پاورقی ثابت. دکمه باید یک دکمه متن با متن و تنظیم رنگ باشد. اگر secondaryButton تنظیم شده باشد ، شما باید primaryButton نیز تنظیم کنید.

DisplayStyle

در افزودنیهای فضای کاری Google ، نحوه نمایش کارت را تعیین می کند.

در دسترس برای افزودنی های فضای کاری Google و برای برنامه های Google Chat در دسترس نیست.

Enums
DISPLAY_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
PEEK هدر کارت در پایین نوار کناری ظاهر می شود ، که بخشی از آن کارت بالایی فعلی پشته را پوشش می دهد. با کلیک بر روی هدر ، کارت را در پشته کارت قرار می دهد. اگر کارت هدر نداشته باشد ، به جای آن از یک هدر تولید شده استفاده می شود.
REPLACE مقدار پیش فرض کارت با تعویض نمای کارت بالا در پشته کارت نشان داده شده است.