Cards v2

卡片

在 Google Chat 消息或 Google Workspace 插件中显示的卡片界面。

卡片支持已定义的布局、按钮等互动式界面元素以及图片等富媒体。使用卡片呈现详细信息、从用户那里收集信息,并引导用户采取下一步行动。

使用卡片构建器设计和预览卡片。

打开卡片构建器

如需了解如何构建卡片,请参阅以下文档:

注意:每张卡片最多可添加 100 个 widget。超出此限制的任何 widget 都会被忽略。此限制适用于 Google Chat 应用中的卡片消息和对话框,以及 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)

包含 widget 的集合。每个部分都有自己的可选标题。各部分之间用分隔线隔开。如需查看 Google Chat 应用中的示例,请参阅定义卡片的一部分

sectionDividerStyle

enum (DividerStyle)

标题、部分和页脚之间的分隔线样式。

cardActions[]

object (CardAction)

卡片的操作。操作会添加到卡片的工具栏菜单中。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

例如,以下 JSON 会构建一个包含 SettingsSend 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 应用。

displayStyle

enum (DisplayStyle)

在 Google Workspace 插件中,设置 peekCardHeader 的显示属性。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

peekCardHeader

object (CardHeader)

显示情境化内容时,预览卡片标题会充当占位符,以便用户在首页卡片和情境化卡片之间向前导航。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

CardHeader

表示卡片标题。如需查看 Google Chat 应用中的示例,请参阅添加标题

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
字段
title

string

必需。卡片标题的名称。标题的高度是固定的:如果同时指定了标题和副标题,则每个标题各占一行。如果仅指定了标题,则标题会占据两行。

subtitle

string

卡片标题的副标题。如果指定,则显示在 title 下方的单独一行中。

imageType

enum (ImageType)

用于剪裁图片的形状。

适用于 Google Chat 应用和 Google Workspace 插件。

imageUrl

string

卡片标题中图片的 HTTPS 网址。

imageAltText

string

此图片的替代文本,用于实现无障碍功能。

ImageType

用于剪裁图片的形状。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
SQUARE 默认值。为图片应用方形遮罩。例如,4x3 的图片会变为 3x3。
CIRCLE 为图片应用圆形蒙版。例如,4x3 的图片会变成直径为 3 的圆形。

部分

一个部分包含一组按指定顺序垂直呈现的 widget。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "collapseControl": {
    object (CollapseControl)
  }
}
字段
header

string

显示在部分顶部的文字。支持简单的 HTML 格式文本。如需详细了解如何设置文本格式,请参阅 在 Google Chat 应用中设置文本格式在 Google Workspace 加载项中设置文本格式

widgets[]

object (Widget)

相应部分中的所有 widget。必须包含至少一个 widget。

collapsible

boolean

指示相应部分是否可收起。

可收起的部分会隐藏部分或全部 widget,但用户可以点击显示更多展开该部分,从而显示隐藏的 widget。用户可以点击减少显示,再次隐藏这些微件。

如需确定哪些 widget 已隐藏,请指定 uncollapsibleWidgetsCount

uncollapsibleWidgetsCount

integer

即使在部分收起时仍保持可见的不可收起 widget 的数量。

例如,如果某个部分包含 5 个 widget,并且 uncollapsibleWidgetsCount 设置为 2,则始终显示前两个 widget,默认情况下会收起后三个 widget。只有当 collapsibletrue 时,系统才会考虑 uncollapsibleWidgetsCount

collapseControl

object (CollapseControl)

可选。定义部分的展开和收起按钮。仅当相应部分可折叠时,系统才会显示此按钮。如果未设置此字段,则使用默认按钮。

widget

每张卡片都由 widget 组成。

widget 是一种复合对象,可以表示文本、图片、按钮和其他对象类型。

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.
}
字段
horizontalAlignment

enum (HorizontalAlignment)

指定 widget 是与列的左侧、右侧还是中心对齐。

联合字段 data。一个 widget 只能包含以下项之一。您可以使用多个 widget 字段来显示更多商品。 data 只能是下列其中一项:
textParagraph

object (TextParagraph)

显示文本段落。支持简单的 HTML 格式文本。如需详细了解如何设置文本格式,请参阅 在 Google Chat 应用中设置文本格式在 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"
}
decoratedText

object (DecoratedText)

显示带装饰的文本项。

例如,以下 JSON 会创建一个显示电子邮件地址的装饰文本 widget:

"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"
  }
}
buttonList

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"
        }
      }
    }
  ]
}
textInput

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"
      }
    ]
  }
}
selectionInput

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
    }
  ]
}
dateTimePicker

object (DateTimePicker)

显示一个微件,让用户输入日期、时间或日期和时间。

例如,以下 JSON 会创建一个用于安排预约的日期时间选择器:

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

object (Divider)

在 widget 之间显示水平线分隔线。

例如,以下 JSON 会创建一个分隔线:

"divider": {
}
grid

object (Grid)

显示包含一系列项的网格。

网格支持任意数量的列和项。行数取决于商品数量上限除以列数。一个包含 10 个项和 2 列的网格有 5 行。一个包含 11 个项和 2 列的网格有 6 行。

适用于 Google Chat 应用和 Google Workspace 插件。

例如,以下 JSON 会创建一个包含单个项的双列网格:

"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 widget。

例如,以下 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)

轮播界面包含一组嵌套的 widget。例如,以下是包含两个文本段落的轮播界面的 JSON 表示法。

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

object (ChipList)

芯片列表。

例如,以下 JSON 会创建两个功能块。第一个是文字 chip,第二个是用于打开链接的图标 chip:

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

TextParagraph

支持格式设置的一段文字。如需查看 Google Chat 应用中的示例,请参阅添加一段格式化文本。如需详细了解如何设置文本格式,请参阅 在 Google Chat 应用中设置文本格式在 Google Workspace 加载项中设置文本格式

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
字段
text

string

微件中显示的文字。

maxLines

integer

widget 中显示的最大文本行数。如果文本超过指定的最大行数,多余的内容会隐藏在显示更多按钮后面。如果文本的行数等于或少于指定的最大行数,则不会显示显示更多按钮。

默认值为 0,在这种情况下,系统会显示所有上下文。系统会忽略负值。

textSyntax

enum (TextSyntax)

文本的语法。如果未设置,则文本会呈现为 HTML。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

TextSyntax

用于设置文本格式的语法。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

枚举
TEXT_SYNTAX_UNSPECIFIED 如果未指定,则文本会呈现为 HTML。
HTML 文本以 HTML 形式呈现。这是默认值。
MARKDOWN 文本会呈现为 Markdown。

图片

由网址指定的图片,可以具有 onClick 操作。如需查看示例,请参阅添加图片

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
字段
imageUrl

string

托管图片的 HTTPS 网址。

例如:

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

object (OnClick)

当用户点击图片时,点击操作会触发此操作。

altText

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 应用。

overflowMenu

object (OverflowMenu)

如果指定,此属性会打开溢出菜单。 onClick

操作

一种用于描述提交表单时的行为的操作。例如,您可以调用 Apps 脚本脚本来处理表单。如果触发了该操作,表单值会发送到服务器。

适用于 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)

操作参数列表。

loadIndicator

enum (LoadIndicator)

指定操作在调用时显示的加载指示器。

persistValues

boolean

指明表单值在操作后是否会保留。默认值为 false

如果值为 true,则在触发操作后,表单值会保留。如需让用户在操作处理期间进行更改,请将 LoadIndicator 设置为 NONE。对于聊天应用中的卡片消息,您还必须将操作的 ResponseType 设置为 UPDATE_MESSAGE,并使用包含该操作的卡片中的同一 cardId

如果值为 false,则在触发操作时清除表单值。为防止用户在处理操作期间进行更改,请将 LoadIndicator 设置为 SPINNER

interaction

enum (Interaction)

可选。打开对话框时必须提供此参数。

在与用户互动(例如用户点击卡片消息中的按钮)时应执行的操作。

如果未指定,应用会像往常一样执行 action(例如打开链接或运行函数)来做出响应。

通过指定 interaction,应用可以以特殊的互动方式做出响应。例如,通过将 interaction 设置为 OPEN_DIALOG,应用可以打开一个对话框。如果指定此标志,则不会显示加载指示器。如果为插件指定了此属性,则整个卡片都会被剥离,并且客户端中不会显示任何内容。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

requiredWidgets[]

string

可选。在此列表中填写相应操作需要哪些 widget 才能有效提交。

如果此处列出的 widget 在调用此操作时没有值,则会中止表单提交。

适用于 Google Chat 应用和 Google Workspace 插件。

allWidgetsAreRequired

boolean

可选。如果此值为 true,则此操作会认为所有 widget 都是必需的。

适用于 Google Chat 应用和 Google Workspace 插件。

ActionParameter

调用操作方法时要提供的字符串形参列表。例如,假设有三个延后按钮:立即延后、延后一天或延后到下周。您可以使用 action method = snooze(),并在字符串参数列表中传递延迟类型和延迟时间。

如需了解详情,请参阅 CommonEventObject

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "key": string,
  "value": string
}
字段
key

string

操作脚本的参数名称。

value

string

参数的值。

LoadIndicator

指定在调用操作时操作显示的加载指示器。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
SPINNER 显示一个微调框,以指示内容正在加载。
NONE 不显示任何内容。

互动

可选。打开对话框时必须提供此参数。

在与用户互动(例如用户点击卡片消息中的按钮)时应执行的操作。

如果未指定,应用会像往常一样执行 action(例如打开链接或运行函数)来做出响应。

通过指定 interaction,应用可以以特殊的互动方式做出响应。例如,通过将 interaction 设置为 OPEN_DIALOG,应用可以打开对话框

如果指定此标志,则不会显示加载指示器。如果为插件指定了此属性,则整个卡片都会被剥离,并且客户端中不会显示任何内容。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

枚举
INTERACTION_UNSPECIFIED 默认值。action 正常执行。
OPEN_DIALOG

打开一个对话框,这是一个基于卡片的窗口界面,供 Chat 应用与用户互动。

仅受聊天应用支持,用于响应卡片消息上的按钮点击。如果为插件指定了此属性,则整个卡片都会被剥离,并且客户端中不会显示任何内容。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

OpenAs

OnClick 操作打开链接时,客户端可以将其作为全尺寸窗口(如果这是客户端使用的框架)或叠加层(例如弹出式窗口)打开。具体实现取决于客户端平台的功能,如果客户端不支持所选值,则可能会忽略该值。 所有客户端都支持 FULL_SIZE

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

枚举
FULL_SIZE 链接会以全尺寸窗口打开(如果客户端使用的是该框架)。
OVERLAY 链接以叠加层的形式打开,例如弹出式窗口。

OnClose

当由 OnClick 操作打开的链接关闭时,客户端执行的操作。

具体实现取决于客户端平台的功能。例如,网络浏览器可能会在带有 OnClose 处理程序的弹出式窗口中打开链接。

如果同时设置了 OnOpenOnClose 处理程序,但客户端平台无法同时支持这两个值,则以 OnClose 为准。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

枚举
NOTHING 默认值。卡片不会重新加载;没有任何反应。
RELOAD

在子窗口关闭后重新加载卡片。

如果与 OpenAs.OVERLAY 结合使用,子窗口将充当模态对话框,并且父卡会被屏蔽,直到子窗口关闭。

OverflowMenu

一种用于显示弹出式菜单的 widget,其中包含用户可调用的一个或多个操作。例如,在卡片中显示非主要操作。当操作无法放入可用空间时,您可以使用此 widget。如需使用,请在支持此 widget 的 widget 的 OnClick 操作中指定此 widget。例如,在 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
}
字段
startIcon

object (Icon)

显示在文本前面的图标。

text

string

必需。用于向用户标识或描述商品的文本。

onClick

object (OnClick)

必需。选择菜单选项时调用的操作。此 OnClick 不得包含 OverflowMenu,系统会舍弃所有指定的 OverflowMenu 并停用相应菜单项。

disabled

boolean

菜单选项是否已停用。默认值为 false。

图标

卡片上的 widget 中显示的图标。如需查看 Google Chat 应用中的示例,请参阅添加图标

支持内置自定义图标。

适用于 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.
}
字段
altText

string

可选。用于无障碍功能的图标的说明。如果未指定,则系统会提供默认值 Button。最佳实践是,为图标显示的内容以及(如果适用)图标执行的操作设置有用的说明。例如,A user's account portraitOpens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat

如果图标是在 Button 中设置的,则当用户将鼠标悬停在按钮上时,altText 会显示为帮助文本。不过,如果按钮还设置了 text,则会忽略图标的 altText

imageType

enum (ImageType)

应用于图片的剪裁样式。在某些情况下,应用裁剪会导致绘制的图片比内置图标大。 CIRCLE

联合字段 icons。卡片上的 widget 中显示的图标。 icons 只能是下列其中一项:
knownIcon

string

显示 Google Workspace 提供的内置图标之一。

例如,如需显示飞机图标,请指定 AIRPLANE。对于公交车,请指定 BUS

如需查看受支持的图标的完整列表,请参阅内置图标

iconUrl

string

显示托管在 HTTPS 网址中的自定义图标。

例如:

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

支持的文件类型包括 .png.jpg

materialIcon

object (MaterialIcon)

显示一个 Google Material 图标

例如,如需显示复选框图标,请使用

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

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

MaterialIcon

一种 Google Material 图标,包含 2, 500 多个选项。

例如,如需显示具有自定义权重和等级的复选框图标,请编写以下代码:

{
  "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

图标是否呈现为填充状态。默认值为 false。

如需预览不同的图标设置,请前往 Google 字体图标,然后调整自定义下的设置。

weight

integer

图标的描边粗细。您可以从 {100, 200, 300, 400, 500, 600, 700} 中选择。如果不存在,则默认值为 400。如果指定了任何其他值,则使用默认值。

如需预览不同的图标设置,请前往 Google 字体图标,然后调整自定义下的设置。

grade

integer

粗细和等级会影响符号的粗细。与调整粗细相比,调整等级更加精细,对符号大小的影响也较小。请从 {-25, 0, 200} 中选择一个值。如果未提供,则默认值为 0。如果指定了任何其他值,则使用默认值。

如需预览不同的图标设置,请前往 Google 字体图标,然后调整自定义下的设置。

DecoratedText

一种用于显示文本的 widget,可选择性地添加装饰,例如文本上方或下方的标签、文本前面的图标、选择 widget 或文本后面的按钮。如需查看 Google Chat 应用中的示例,请参阅显示带有装饰性文字的文本

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "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

startIcon

object (Icon)

显示在文本前面的图标。

startIconVerticalAlignment

enum (VerticalAlignment)

可选。开始图标的垂直对齐方式。如果未设置,图标将垂直居中。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

topLabel

string

显示在 text 上方的文字。始终会截断。

topLabelText

object (TextParagraph)

TextParagraph 等效于 topLabel。始终会截断。允许比 topLabel 更复杂的格式设置。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

text

string

必需。主要文字。

支持简单格式。如需详细了解如何设置文本格式,请参阅 在 Google Chat 应用中设置文本格式在 Google Workspace 加载项中设置文本格式

contentText

object (TextParagraph)

TextParagraph 等效于 text。允许比 text 更复杂的格式设置。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

wrapText

boolean

文字环绕设置。如果值为 true,则文本会换行并显示在多行中。否则,文本会被截断。

仅适用于 text,不适用于 topLabelbottomLabel

bottomLabel

string

显示在 text 下方的文字。始终换行。

bottomLabelText

object (TextParagraph)

TextParagraph 等效于 bottomLabel。始终换行。允许比 bottomLabel 更复杂的格式设置。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

onClick

object (OnClick)

当用户点击 topLabelbottomLabel 时,系统会触发此操作。

联合字段 controldecoratedText widget 中显示在文字右侧的按钮、开关、复选框或图片。 control 只能是下列其中一项:
button

object (Button)

用户可以点击以触发操作的按钮。

switchControl

object (SwitchControl)

一种开关 widget,用户可以点击它来更改其状态并触发操作。

endIcon

object (Icon)

显示在文字后面的图标。

支持内置自定义图标。

VerticalAlignment

表示垂直对齐属性。

枚举
VERTICAL_ALIGNMENT_UNSPECIFIED 未指定类型。请勿使用。
TOP 与顶部位置对齐。
MIDDLE 与中间位置对齐。
BOTTOM 对齐到底部位置。

按钮

用户可以点击的文本、图标或文本和图标按钮。如需查看 Google Chat 应用中的示例,请参阅添加按钮

如需将图片设为可点击的按钮,请指定 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)

按钮内显示的图标。如果同时设置了 icontext,则图标会显示在文字前面。

color

object (Color)

可选。按钮的颜色。如果设置了此属性,按钮 type 会设置为 FILLED,并且 texticon 字段的颜色会设置为对比鲜明的颜色,以提高可读性。例如,如果按钮颜色设置为蓝色,则按钮中的任何文字或图标都会设置为白色。

如需设置按钮颜色,请为 redgreenblue 字段指定值。该值必须是介于 0 到 1 之间的浮点数,基于 RGB 颜色值,其中 0 (0/255) 表示没有颜色,而 1 (255/255) 表示颜色强度最大。

例如,以下代码会将颜色设置为红色,且强度最高:

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

alpha 字段不适用于按钮颜色。如果指定,系统会忽略此字段。

onClick

object (OnClick)

必需。用户点击按钮时要执行的操作,例如打开超链接或运行自定义函数。

disabled

boolean

如果值为 true,则按钮会以非活动状态显示,并且不会响应用户操作。

altText

string

用于辅助功能的替代文本。

设置描述性文本,让用户了解按钮的作用。例如,如果某个按钮用于打开超链接,您可能会这样写:“打开新的浏览器标签页,并前往 Google Chat 开发者文档,网址为 https://developers.google.com/workspace/chat"。”

type

enum (Type)

可选。按钮的类型。如果未设置,按钮类型默认为 OUTLINED。如果设置了 color 字段,系统会强制将按钮类型设为 FILLED,并忽略为此字段设置的任何值。

颜色

表示 RGBA 颜色空间中的一种颜色。这种表示法旨在简化与各种语言的颜色表示法之间的转换,而不是追求紧凑性。例如,此表示形式的字段可以轻松地提供给 Java 中 java.awt.Color 的构造函数;也可以轻松地提供给 iOS 中 UIColor 的 +colorWithRed:green:blue:alpha 方法;只需稍作处理,即可轻松地将其格式化为 JavaScript 中的 CSS rgba() 字符串。

此参考页面不包含应用于解释 RGB 值的绝对颜色空间(例如 sRGB、Adobe RGB、DCI-P3 和 BT.2020)的相关信息。默认情况下,应用应采用 sRGB 颜色空间。

在需要确定颜色是否相等时,除非另有说明,否则如果两种颜色的红色、绿色、蓝色和 Alpha 值各自相差最多 1e-5,实现会将这两种颜色视为相等。

示例 (Java):

 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;
}
// ...

示例 (JavaScript):

// ...

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 表示完全透明的颜色。它会使用封装容器消息,而非简单的浮动标量,以便区分默认值和未设置的值。如果省略此字段,此颜色对象将呈现为纯色(就像已明确给定 Alpha 值为 1.0)。

类型

可选。按钮的类型。如果设置了 color 字段,则强制将 type 设置为 FILLED

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

枚举
TYPE_UNSPECIFIED 请勿使用。未指定。
OUTLINED 轮廓按钮属于中强调度按钮。它们通常包含重要的操作,但不是 Chat 应用或插件中的主要操作。
FILLED 填充按钮的容器具有纯色。它具有最强的视觉冲击力,建议用于 Chat 应用或插件中的重要操作和主要操作。
FILLED_TONAL 填充色调按钮是填充按钮和轮廓按钮之间的中间替代方案。在需要比轮廓按钮略微强调的低优先级按钮的上下文中,它们非常有用。
BORDERLESS 按钮在默认状态下没有不可见的容器。它通常用于优先级最低的操作,尤其是在呈现多个选项时。

SwitchControl

切换样式的开关或 decoratedText widget 内的复选框。

适用于 Google Chat 应用和 Google Workspace 插件。

仅在 decoratedText widget 中受支持。

JSON 表示法
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
字段
name

string

开关 widget 在表单输入事件中的标识名称。

如需详细了解如何处理表单输入,请参阅接收表单数据

value

string

用户输入的值,作为表单输入事件的一部分返回。

如需详细了解如何处理表单输入,请参阅接收表单数据

selected

boolean

当值为 true 时,选择开关。

onChangeAction

object (Action)

开关状态发生变化时要执行的操作,例如要运行的函数。

controlType

enum (ControlType)

开关在界面中的显示方式。

适用于 Google Chat 应用和 Google Workspace 插件。

ControlType

开关在界面中的显示方式。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
SWITCH 切换开关。
CHECKBOX 已弃用,取而代之的是 CHECK_BOX
CHECK_BOX 复选框。

ButtonList

水平布局的按钮列表。如需查看 Google Chat 应用中的示例,请参阅添加按钮

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "buttons": [
    {
      object (Button)
    }
  ]
}
字段
buttons[]

object (Button)

按钮数组。

TextInput

用户可以在其中输入文本的字段。支持建议和更改时操作。支持表单提交验证。当 Action.all_widgets_are_required 设置为 true 或在 Action.required_widgets 中指定此 widget 时,除非输入值,否则提交操作会被阻止。如需查看 Google Chat 应用中的示例,请参阅添加可供用户输入文本的字段

在表单输入事件期间,聊天应用会接收并处理所输入文本的值。如需详细了解如何处理表单输入,请参阅接收表单数据

当您需要从用户那里收集未定义或抽象数据时,请使用文本输入。如需从用户处收集已定义或已枚举的数据,请使用 SelectionInput widget。

适用于 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

显示在界面中文字输入字段上方的文字。

指定有助于用户输入应用所需信息的文字。例如,如果您要询问某人的姓名,但特别需要对方的姓氏,请使用 surname 而不是 name

如果未指定 hintText,则必须使用此属性。否则,为可选。

hintText

string

显示在文本输入字段下方的文字,旨在通过提示用户输入特定值来帮助用户。此文本始终可见。

如果未指定 label,则必须使用此属性。否则,为可选。

value

string

用户输入的值,作为表单输入事件的一部分返回。

如需详细了解如何处理表单输入,请参阅接收表单数据

type

enum (Type)

文本输入字段在界面中的显示方式。例如,字段是单行还是多行。

onChangeAction

object (Action)

当文本输入字段发生更改时应执行的操作。例如,用户向字段中添加内容或删除文本。

可采取的操作包括运行自定义函数或在 Google Chat 中打开对话框

initialSuggestions

object (Suggestions)

用户可以输入的建议值。当用户点击文本输入字段时,系统会显示这些值。随着用户输入内容,建议值会动态过滤,以匹配用户输入的内容。

例如,编程语言的文本输入字段可能会建议 Java、JavaScript、Python 和 C++。当用户开始输入 Jav 时,建议列表会过滤为仅显示 JavaJavaScript

建议值有助于引导用户输入您的应用可以理解的值。在提及 JavaScript 时,有些用户可能会输入 javascript,而其他用户可能会输入 java script。建议 JavaScript 可以标准化用户与应用的互动方式。

如果指定了该值,则 TextInput.type 始终为 SINGLE_LINE,即使将其设置为 MULTIPLE_LINE 也是如此。

适用于 Google Chat 应用和 Google Workspace 插件。

autoCompleteAction

object (Action)

可选。指定当文本输入字段向与之互动的用户提供建议时要采取的操作。

如果未指定,建议由 initialSuggestions 设置,并由客户端处理。

如果指定了此属性,应用会执行此处指定的操作,例如运行自定义函数。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

validation

object (Validation)

指定此文本字段所需的输入格式验证。

适用于 Google Chat 应用和 Google Workspace 插件。

placeholderText

string

当文本输入字段为空时,该字段中显示的文本。使用此文本提示用户输入值。例如,Enter a number from 0 to 100

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

类型

文本输入字段在界面中的显示方式。例如,是单行输入字段还是多行输入字段。如果指定了 initialSuggestions,则 type 始终为 SINGLE_LINE,即使将其设置为 MULTIPLE_LINE 也是如此。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
SINGLE_LINE 文本输入字段的高度固定为一行。
MULTIPLE_LINE 文本输入字段的高度固定为多行。

RenderActions

一组渲染指令,用于指示卡片执行操作,或指示加购项宿主应用或 Chat 应用执行应用专属操作。

适用于 Google Chat 应用和 Google Workspace 插件。

字段
action

Action

操作

字段
navigations[]

Navigation

推送、弹出或更新卡片。

Google Chat 中的插件

向堆栈添加新卡片(向前导航)。对于 Chat 应用,仅适用于应用首页

适用于 Google Chat 应用和 Google Workspace 插件。

navigations: {
  pushCard: CARD
}

用新卡替换顶部卡片。对于 Chat 应用,仅适用于应用首页

适用于 Google Chat 应用和 Google Workspace 插件。

navigations: {
  updateCard: CARD
}

建议

用户可以输入的建议值。当用户点击文本输入字段时,系统会显示这些值。随着用户输入,建议值会动态过滤,以匹配用户输入的内容。

例如,编程语言的文本输入字段可能会建议 Java、JavaScript、Python 和 C++。当用户开始输入 Jav 时,建议列表会过滤为仅显示 JavaJavaScript

建议值有助于引导用户输入您的应用可以理解的值。在提及 JavaScript 时,有些用户可能会输入 javascript,而其他用户可能会输入 java script。建议 JavaScript 可以标准化用户与应用的互动方式。

如果指定了该值,则 TextInput.type 始终为 SINGLE_LINE,即使将其设置为 MULTIPLE_LINE 也是如此。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
字段
items[]

object (SuggestionItem)

用于文本输入字段中的自动补全建议的建议列表。

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

文本输入字段的建议输入值。这相当于用户自行输入的内容。

验证

表示验证所附加 widget 所需的数据。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
字段
characterLimit

integer

指定文本输入 widget 的字符数限制。请注意,此属性仅用于文本输入,对于其他 widget 会被忽略。

适用于 Google Chat 应用和 Google Workspace 插件。

inputType

enum (InputType)

指定输入 widget 的类型。

适用于 Google Chat 应用和 Google Workspace 插件。

InputType

输入 widget 的类型。

枚举
INPUT_TYPE_UNSPECIFIED 未指定类型。请勿使用。
TEXT 接受所有字符的常规文本。
INTEGER 一个整数值。
FLOAT 一个浮点值。
EMAIL 电子邮件地址。
EMOJI_PICKER 从系统提供的表情符号选择器中选择的表情符号。

SelectionInput

用于创建一个或多个可供用户选择的界面项的 widget。仅支持对 dropdownmultiselect 菜单的表单提交进行验证。当 Action.all_widgets_are_required 设置为 true 或在 Action.required_widgets 中指定此 widget 时,除非选择一个值,否则提交操作会被阻止。例如,下拉菜单或复选框。您可以使用此 widget 收集可预测或可枚举的数据。如需查看 Google Chat 应用中的示例,请参阅添加可选择的界面元素

聊天应用可以处理用户选择或输入的商品的值。如需详细了解如何处理表单输入,请参阅接收表单数据

如需从用户处收集未定义或抽象数据,请使用 TextInput widget。

适用于 Google Chat 应用和 Google Workspace 插件。

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 widget 中向用户显示的商品类型。选择类型支持不同类型的互动。例如,用户可以选择一个或多个复选框,但只能从下拉菜单中选择一个值。

items[]

object (SelectionItem)

一个可选择项的数组。例如,单选按钮或复选框的数组。最多支持 100 个项目。

onChangeAction

object (Action)

如果指定了该属性,则在选择发生更改时提交表单。如果未指定,您必须指定一个单独的按钮来提交表单。

如需详细了解如何处理表单输入,请参阅接收表单数据

multiSelectMaxSelectedItems

integer

对于多选菜单,用户可以选择的最大项数。最小值为 1 件商品。如果未指定,则默认为 3 项。

multiSelectMinQueryLength

integer

对于多选菜单,用户输入多少个文本字符后,菜单会返回建议的选择项。

如果未设置,多选菜单将使用以下默认值:

  • 如果菜单使用 SelectionInput 项的静态数组,则默认为 0 个字符,并立即从数组中填充项。
  • 如果菜单使用动态数据源 ( multi_select_data_source),则默认在查询数据源以返回建议项之前使用 3 个字符。

联合字段 multi_select_data_source。对于多选菜单,一种动态填充选择项的数据源。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。 multi_select_data_source 只能是下列其中一项:

externalDataSource

object (Action)

外部数据源,例如关系型数据库。

platformDataSource

object (PlatformDataSource)

Google Workspace 中的数据源。

SelectionType

用户可选择的商品的格式。不同的选项支持不同类型的互动。例如,用户可以选择多个复选框,但只能从下拉菜单中选择一项。

每个选择输入源都支持一种选择类型。例如,不支持混合使用复选框和开关。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
CHECK_BOX 一组复选框。用户可以选择一个或多个复选框。
RADIO_BUTTON 一组单选按钮。用户可以选择一个单选按钮。
SWITCH 一组开关。用户可以开启一个或多个开关。
DROPDOWN 一个下拉菜单。用户可以从菜单中选择一项。
MULTI_SELECT

包含文本框的菜单。用户可以输入文字并选择一项或多项内容。对于 Google Workspace 加载项,您必须使用 SelectionItem 对象的静态数组来填充项。

对于 Google Chat 应用,您还可以使用动态数据源填充项,并在用户在菜单中输入内容时自动建议项。例如,用户可以开始输入 Google Chat 聊天室的名称,然后 widget 会自动建议该聊天室。如需动态填充多选菜单的项,请使用以下类型的数据源之一:

  • Google Workspace 数据:使用 Google Workspace 中的数据填充项目,例如 Google Workspace 用户或 Google Chat 群组。
  • 外部数据:内容来自 Google Workspace 外部的外部数据源。

如需查看如何为 Chat 应用实现多选菜单的示例,请参阅添加多选菜单

适用于 Google Chat 应用和 Google Workspace 插件。

SelectionItem

用户可在选择输入源(例如复选框或开关)中选择的项。最多支持 100 个项目。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "text": string,
  "value": string,
  "selected": boolean,
  "bottomText": string,

  // Union field start_icon can be only one of the following:
  "startIconUri": string
  // End of list of possible types for union field start_icon.
}
字段
text

string

用于向用户标识或描述商品的文本。

value

string

与相应商品相关联的值。客户端应将此值用作表单输入值。

如需详细了解如何处理表单输入,请参阅接收表单数据

selected

boolean

相应项是否默认处于选中状态。如果选择输入仅接受一个值(例如对于单选按钮或下拉菜单),则仅为一个项设置此字段。

bottomText

string

对于多选菜单,显示在项目 text 字段下方的文本说明或标签。

联合字段 start_icon。对于多选菜单,显示在相应项的 text 字段旁边的图标的网址。支持 PNG 和 JPEG 文件。必须是 HTTPS 网址。例如,https://developers.google.com/workspace/chat/images/quickstart-app-avatar.pngstart_icon 只能是下列其中一项:
startIconUri

string

PlatformDataSource

对于使用多选菜单的 SelectionInput widget,数据源来自 Google Workspace。用于填充多选菜单中的项。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

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.
}
字段
联合字段 data_source。数据源。 data_source 只能是下列其中一项:
commonDataSource

enum (CommonDataSource)

由所有 Google Workspace 应用共享的数据源,例如 Google Workspace 组织中的用户。

hostAppDataSource

object (HostAppDataSourceMarkup)

Google Workspace 宿主应用特有的数据源,例如 Google Chat 中的聊天室。

此字段支持 Google API 客户端库,但在 Cloud 客户端库中不可用。如需了解详情,请参阅安装客户端库

CommonDataSource

由所有 Google Workspace 应用共享的数据源。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

枚举
UNKNOWN 默认值。请勿使用。
USER Google Workspace 用户。用户只能查看和选择其 Google Workspace 组织中的用户。

HostAppDataSourceMarkup

对于使用多选菜单的 SelectionInput widget,数据源来自 Google Workspace 应用。数据源用于填充多选菜单的选择项。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

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.
}
字段
联合字段 data_source。用于填充多选菜单项的 Google Workspace 应用。 data_source 只能是下列其中一项:
chatDataSource

object (ChatClientDataSourceMarkup)

来自 Google Chat 的数据源。

ChatClientDataSourceMarkup

对于使用多选菜单的 SelectionInput widget,数据源来自 Google Chat。数据源用于填充多选菜单的选择项。例如,用户可以选择自己是成员的 Google Chat 聊天室。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

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 Chat 数据源。 source 只能是下列其中一项:
spaceDataSource

object (SpaceDataSource)

用户所属的 Google Chat 聊天室。

SpaceDataSource

一种数据源,用于将 Google Chat 聊天室填充为多选菜单的选择项。仅填充用户所属的聊天室。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

JSON 表示法
{
  "defaultToCurrentSpace": boolean
}
字段
defaultToCurrentSpace

boolean

如果设置为 true,则多选菜单默认选择当前 Google Chat 聊天室作为项。

DateTimePicker

允许用户输入日期、时间或日期和时间。支持表单提交验证。当 Action.all_widgets_are_required 设置为 true 或在 Action.required_widgets 中指定此 widget 时,除非选择一个值,否则提交操作会被阻止。如需查看 Google Chat 应用中的示例,请参阅让用户选择日期和时间

用户可以输入文字,也可以使用选择器选择日期和时间。如果用户输入了无效的日期或时间,选择器会显示一条错误消息,提示用户正确输入信息。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": int64,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
字段
name

string

在表单输入事件中标识 DateTimePicker 的名称。

如需详细了解如何处理表单输入,请参阅接收表单数据

label

string

提示用户输入日期、时间或日期和时间的文本。例如,如果用户正在安排预约,请使用 Appointment dateAppointment date and time 等标签。

type

enum (DateTimePickerType)

widget 是否支持输入日期、时间或日期和时间。

valueMsEpoch

int64

微件中显示的默认值,以自 Unix 纪元时间以来的毫秒数表示。

根据选择器的类型 (DateTimePickerType) 指定值:

  • DATE_AND_TIME :世界协调时间 (UTC) 的日历日期和时间。例如,如需表示 2023 年 1 月 1 日中午 12:00(世界协调时间),请使用 1672574400000
  • DATE_ONLY :世界协调时间 (UTC) 00:00:00 的日历日期。例如,如需表示 2023 年 1 月 1 日,请使用 1672531200000
  • TIME_ONLY :世界协调时间 (UTC) 中的时间。例如,如需表示下午 12:00,请使用 43200000 (或 12 * 60 * 60 * 1000)。
timezoneOffsetDate

integer

表示与世界协调时间 (UTC) 的时区偏移量(以分钟为单位)的数字。如果设置了此属性,则 valueMsEpoch 会以指定的时区显示。如果未设置,该值默认为用户的时区设置。

onChangeAction

object (Action)

当用户在 DateTimePicker 界面中点击保存清除时触发。

DateTimePickerType

DateTimePicker widget 中日期和时间的格式。确定用户能否输入日期、时间或同时输入日期和时间。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
DATE_AND_TIME 用户输入日期和时间。
DATE_ONLY 用户输入日期。
TIME_ONLY 用户输入时间。

分隔线

此类型没有字段。

以水平线形式显示 widget 之间的分隔线。如需查看 Google Chat 应用中的示例,请参阅在 widget 之间添加水平分隔线

适用于 Google Chat 应用和 Google Workspace 插件。

例如,以下 JSON 会创建一个分隔线:

"divider": {}

网格

显示包含一系列项的网格。商品只能包含文字或图片。对于自适应列,或要添加除文字或图片以外的内容,请使用 Columns。如需查看 Google Chat 应用中的示例,请参阅显示包含一系列商品的网格

网格支持任意数量的列和项。行数由商品数除以列数得出。一个包含 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"
    }
  }
}
JSON 表示法
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
字段
title

string

网格标题中显示的文字。

items[]

object (GridItem)

要在网格中显示的项。

borderStyle

object (BorderStyle)

要应用于每个网格项的边框样式。

columnCount

integer

网格中要显示的列数。如果未指定此字段,系统会使用默认值,而该默认值会因网格的显示位置(对话框与配套应用)而异。

onClick

object (OnClick)

每个网格项都会重复使用此回调,但回调的参数中会添加相应项的标识符和在项列表中的索引。

GridItem

表示网格布局中的项。商品可以包含文字、图片,也可以同时包含文字和图片。

适用于 Google Chat 应用和 Google Workspace 插件。

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)

用于网格项的布局。

ImageComponent

表示图片。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
字段
imageUri

string

图片网址。

altText

string

图片的无障碍功能标签。

cropStyle

object (ImageCropStyle)

要应用于图片的剪裁样式。

borderStyle

object (BorderStyle)

要应用于图片的边框样式。

ImageCropStyle

表示应用于图片的剪裁样式。

适用于 Google Chat 应用和 Google Workspace 插件。

例如,以下展示了如何应用 16:9 的宽高比:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
JSON 表示法
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
字段
type

enum (ImageCropType)

裁剪类型。

aspectRatio

number

如果剪裁类型为 RECTANGLE_CUSTOM,则使用此宽高比。

例如,以下展示了如何应用 16:9 的宽高比:

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

ImageCropType

表示应用于图片的剪裁样式。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
IMAGE_CROP_TYPE_UNSPECIFIED 请勿使用。未指定。
SQUARE 默认值。应用方形裁剪。
CIRCLE 应用圆形裁剪。
RECTANGLE_CUSTOM 应用具有自定义宽高比的矩形剪裁。使用 aspectRatio 设置自定义宽高比。
RECTANGLE_4_3 应用宽高比为 4:3 的矩形剪裁。

BorderStyle

卡片或 widget 边框的样式选项,包括边框类型和颜色。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
字段
type

enum (BorderType)

边框类型。

strokeColor

object (Color)

当类型为 BORDER_TYPE_STROKE 时要使用的颜色。

如需设置笔画颜色,请为 redgreenblue 字段指定值。该值必须是介于 0 到 1 之间的浮点数,基于 RGB 颜色值,其中 0 (0/255) 表示没有颜色,而 1 (255/255) 表示颜色强度最大。

例如,以下代码会将颜色设置为红色,且强度最高:

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

alpha 字段不适用于描边颜色。如果指定,系统会忽略此字段。

cornerRadius

integer

边框的圆角半径。

BorderType

表示应用于 widget 的边框类型。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
BORDER_TYPE_UNSPECIFIED 请勿使用。未指定。
NO_BORDER 无边框。
STROKE 默认值。大纲。

GridItemLayout

表示网格项可用的各种布局选项。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
GRID_ITEM_LAYOUT_UNSPECIFIED 请勿使用。未指定。
TEXT_BELOW 标题和字幕显示在网格项的图片下方。
TEXT_ABOVE 标题和副标题显示在网格项的图片上方。

Columns widget 最多可在卡片或对话框中显示 2 列。您可以向每个列添加 widget;widget 会按指定的顺序显示。如需查看 Google Chat 应用中的示例,请参阅以列形式显示卡片和对话框

每列的高度由较高的列决定。例如,如果第一列比第二列高,则两列的高度都与第一列相同。由于每列可以包含不同数量的 widget,因此您无法定义行或在列之间对齐 widget。

列会并排显示。您可以使用 HorizontalSizeStyle 字段自定义每列的宽度。如果用户的屏幕宽度过窄,第二列会换行到第一列下方:

  • 在网页上,如果屏幕宽度小于或等于 480 像素,则第二列会换行。
  • 在 iOS 设备上,如果屏幕宽度小于或等于 300 pt,则第二列会换行。
  • 在 Android 设备上,如果屏幕宽度小于或等于 320 dp,则第二列会换行。

如需添加两列以上的列,或使用行,请使用 Grid widget。

适用于 Google Chat 应用和 Google Workspace 插件。支持列的插件界面包括:

  • 当用户从电子邮件草稿中打开插件时显示的对话框。
  • 用户通过 Google 日历活动中的添加附件菜单打开插件时显示的对话框。
JSON 表示法
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
字段
columnItems[]

object (Column)

列数组。您可以在卡片或对话框中添加最多 2 列。

A 列。

Google Workspace 插件和 Chat 应用

JSON 表示法
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
字段
horizontalSizeStyle

enum (HorizontalSizeStyle)

指定列如何填充卡片的宽度。

horizontalAlignment

enum (HorizontalAlignment)

指定 widget 是与列的左侧、右侧还是中心对齐。

verticalAlignment

enum (VerticalAlignment)

指定 widget 是与列的顶部、底部还是中心对齐。

widgets[]

object (Widgets)

列中包含的 widget 数组。微件会按指定顺序显示。

HorizontalSizeStyle

指定列如何填充卡片的宽度。每列的宽度取决于 HorizontalSizeStyle 和列内 widget 的宽度。

Google Workspace 插件和 Chat 应用

枚举
HORIZONTAL_SIZE_STYLE_UNSPECIFIED 请勿使用。未指定。
FILL_AVAILABLE_SPACE 默认值。列会填充可用空间,最多可占卡片宽度的 70%。如果两个列都设置为 FILL_AVAILABLE_SPACE,则每个列会填充 50% 的空间。
FILL_MINIMUM_SPACE 列尽可能少地占用空间,且不超过卡片宽度的 30%。

HorizontalAlignment

指定 widget 是与列的左侧、右侧还是中心对齐。

适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

枚举
HORIZONTAL_ALIGNMENT_UNSPECIFIED 请勿使用。未指定。
START 默认值。将 widget 与列的起始位置对齐。对于从左到右的布局,则与左侧对齐。对于从右到左的布局,则靠右对齐。
CENTER 将 widget 对齐到列的中心。
END 将 widget 对齐到列的末尾位置。对于从左向右的布局,将 widget 对齐到右侧。对于从右到左的布局,将 widget 对齐到左侧。

VerticalAlignment

指定 widget 是与列的顶部、底部还是中心对齐。

Google Workspace 插件和 Chat 应用

枚举
VERTICAL_ALIGNMENT_UNSPECIFIED 请勿使用。未指定。
CENTER 默认值。将 widget 与列的中心对齐。
TOP 将 widget 与列的顶部对齐。
BOTTOM 将 widget 与列的底部对齐。

微件

您可以包含在列中的受支持 widget。

Google Workspace 插件和 Chat 应用

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 只能是下列其中一项:

textParagraph

object (TextParagraph)

TextParagraph 微件。

image

object (Image)

Image 微件。

decoratedText

object (DecoratedText)

DecoratedText 微件。

buttonList

object (ButtonList)

ButtonList 微件。

textInput

object (TextInput)

TextInput 微件。

selectionInput

object (SelectionInput)

SelectionInput 微件。

dateTimePicker

object (DateTimePicker)

DateTimePicker 微件。

chipList

object (ChipList)

ChipList 微件。

ChipList

水平布局的条状标签列表,可以水平滚动或换行。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
字段
layout

enum (Layout)

指定了条状标签列表布局。

chips[]

object (Chip)

芯片数组。

布局

条状标签列表布局。

枚举
LAYOUT_UNSPECIFIED 请勿使用。未指定。
WRAPPED 默认值。如果横向空间不足,芯片列表会换行。
HORIZONTAL_SCROLLABLE 如果芯片无法放入可用空间,则会水平滚动。

Chip

用户可以点击的文字、图标或文字和图标组合的 chip。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
字段
icon

object (Icon)

图标图片。如果同时设置了 icontext,则图标会显示在文字前面。

label

string

条状标签内显示的文字。

onClick

object (OnClick)

可选。用户点击条状标签时要执行的操作,例如打开超链接或运行自定义函数。

enabled
(deprecated)

boolean

相应 chip 是否处于有效状态并响应用户操作。默认值为 true。已弃用。请改用 disabled

disabled

boolean

芯片是否处于非活动状态并忽略用户操作。默认值为 false

altText

string

用于辅助功能的替代文本。

设置描述性文字,让用户了解相应条状标签的作用。例如,如果某个功能块会打开一个超链接,请写明:“打开一个新的浏览器标签页,并前往 https://developers.google.com/workspace/chat" 中的 Google Chat 开发者文档。”

轮播界面(也称为滑块)会以幻灯片格式轮流显示一系列微件,并提供用于前往上一个或下一个微件的按钮。

例如,以下是包含三个文本段落 widget 的轮播界面的 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 Workspace 加购项。

JSON 表示法
{
  "carouselCards": [
    {
      object (CarouselCard)
    }
  ]
}
字段
carouselCards[]

object (CarouselCard)

轮播界面中包含的卡片列表。

CarouselCard

可显示为轮播界面项的卡片。 适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

JSON 表示法
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
字段
widgets[]

object (NestedWidget)

轮播卡片中显示的 widget 列表。微件会按指定顺序显示。

footerWidgets[]

object (NestedWidget)

轮播界面卡片底部显示的 widget 列表。微件会按指定顺序显示。

NestedWidget

可在包含布局(例如 CarouselCard)中显示的 widget 的列表。 适用于 Google Chat 应用,但不适用于 Google Workspace 加购项。

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 只能是下列其中一项:

textParagraph

object (TextParagraph)

文本段落 widget。

buttonList

object (ButtonList)

一个按钮列表 widget。

image

object (Image)

图片 widget。

CollapseControl

表示展开和收起控件。

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
字段
horizontalAlignment

enum (HorizontalAlignment)

展开和收起按钮的水平对齐方式。

expandButton

object (Button)

可选。定义一个可自定义的按钮以展开该部分。必须同时设置 expandButton 和 collapseButton 字段。仅设置一个字段集不会生效。如果未设置此字段,则使用默认按钮。

collapseButton

object (Button)

可选。定义一个可自定义的按钮来收起相应部分。必须同时设置 expandButton 和 collapseButton 字段。仅设置一个字段集不会生效。如果未设置此字段,则使用默认按钮。

DividerStyle

卡片的分隔线样式。目前仅用于卡片部分之间的分隔线。

适用于 Google Chat 应用和 Google Workspace 插件。

枚举
DIVIDER_STYLE_UNSPECIFIED 请勿使用。未指定。
SOLID_DIVIDER 默认选项。渲染实心分隔线。
NO_DIVIDER 如果设置了该属性,则不会渲染分隔线。此样式会从布局中完全移除分隔线。结果相当于根本不添加分隔线。

CardAction

卡片操作是指与卡片关联的操作。例如,账单卡片可能包含“删除账单”“通过电子邮件发送账单”或“在浏览器中打开账单”等操作。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

JSON 表示法
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
字段
actionLabel

string

显示为操作菜单项的标签。

onClick

object (OnClick)

相应待办项的 onClick 操作。

CardFixedFooter

显示在卡片底部的持久性(粘性)页脚。

设置 fixedFooter 但不指定 primaryButtonsecondaryButton 会导致错误。

对于 Chat 应用,您可以在对话框中使用固定页脚,但不能在卡片消息中使用。如需查看 Google Chat 应用中的示例,请参阅添加持久性页脚

适用于 Google Chat 应用和 Google Workspace 插件。

JSON 表示法
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
字段
primaryButton

object (Button)

固定页脚的主要按钮。按钮必须是文本按钮,并且设置了文本和颜色。

secondaryButton

object (Button)

固定页脚的辅助按钮。按钮必须是设置了文字和颜色的文字按钮。如果设置了 secondaryButton,您还必须设置 primaryButton

DisplayStyle

在 Google Workspace 插件中,用于确定卡片的显示方式。

适用于 Google Workspace 加购项,但不适用于 Google Chat 应用。

枚举
DISPLAY_STYLE_UNSPECIFIED 请勿使用。未指定。
PEEK 卡片的标题显示在边栏底部,部分遮盖了堆栈中当前的顶部卡片。点击标题会将卡片弹出到卡片堆栈中。如果卡片没有标题,则系统会改用生成的标题。
REPLACE 默认值。通过替换卡片堆栈中顶部卡片的视图来显示卡片。