Cards v1

卡

卡片是一种界面元素，可以包含文本和图片等界面 widget。

JSON 表示法 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
字段
header

object (CardHeader)

卡片的标头。标头通常包含标题和图片。
sections[]

object (Section)

部分通过分隔线分隔。

cardActions[]

object (CardAction)

此卡片的操作。

name

string

卡的名称。

CardHeader

JSON 表示法 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
字段
title

string

必须指定标题。标题具有固定的高度：如果同时指定了标题和副标题，则标题各占一行。如果您只指定标题，系统会占用两行。

subtitle

string

卡片标题的副标题。

imageStyle

enum (ImageStyle)

图片的类型（例如方形或圆形边框）。

imageUrl

string

卡片标题中图片的网址。

图片样式

枚举
IMAGE_STYLE_UNSPECIFIED
IMAGE 方形边框。
AVATAR 圆形边框。

章节

某个部分包含一系列 widget（按指定顺序渲染，即垂直渲染）。在所有平台中，卡片的宽度较小，因此目前不需要布局属性（例如浮点数）。

JSON 表示法 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
字段
header

string

相应部分的标头。支持设置了格式的文本。如需详细了解如何设置文本格式，请参阅在 Google Chat 应用中设置文本格式和在 Google Workspace 插件中设置文本格式。

widgets[]

object (WidgetMarkup)

版块必须至少包含一个 widget。

WidgetMarkup

widget 是呈现文本和图片的界面元素。

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

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
字段
buttons[]

object (Button)

按钮列表。按钮也是 oneof data，因此应仅设置其中一个字段。
联合字段 data。WidgetMarkup 只能包含以下其中一项。您可以使用多个 WidgetMarkup 字段显示更多项。 data 只能是下列其中一项：
textParagraph

object (TextParagraph)

在此微件中显示文本段落。
image

object (Image)

在此微件中显示图片。
keyValue

object (KeyValue)

在此 widget 中显示一个键值对项。

文本段落

一段文本。支持带格式的文本。如需详细了解如何设置文本格式，请参阅在 Google Chat 应用中设置文本格式和在 Google Workspace 插件中设置文本格式。

JSON 表示法 
{
  "text": string
}
字段
text

string

图片

由网址指定且可具有 onclick 操作的图片。

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

string

图片的网址。

onClick

object (OnClick)

onclick 操作。
aspectRatio

number

此图片的宽高比（宽度和高度）。借助此字段，您可以在等待图片加载期间为图片保留合适的高度。它不会替换图片的内置宽高比。如果未设置此政策，服务器将通过预提取图片来填充它。

OnClick

onclick 操作（例如，打开链接）。

JSON 表示法 
{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
字段

联合字段 data。

data 只能是下列其中一项：

action

object (FormAction)

如果已指定，则此 onclick 操作会触发表单操作。

表单操作

表单操作用于说明提交表单时的行为。例如，您可以调用 Apps 脚本来处理表单。

JSON 表示法 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
字段
actionMethodName

string

方法名称用于标识表单的哪一部分触发了表单提交。此信息将作为卡片点击事件的一部分回显到 Chat 应用中。您可以对多个触发常见行为的元素使用相同的方法名称。
parameters[]

object (ActionParameter)

操作参数列表。

ActionParameter

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

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

string

操作脚本的参数名称。

value

string

参数的值。

键值对

界面元素包含一个键（标签）和一个值（内容）。该元素还可以包含一些操作，例如 onclick 按钮。

JSON 表示法 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
字段
topLabel

string

顶部标签的文本。支持带格式的文本。如需详细了解如何设置文本格式，请参阅在 Google Chat 应用中设置文本格式和在 Google Workspace 插件中设置文本格式。

content

string

内容的文本。支持带格式的文本，且始终为必填项。如需详细了解如何设置文本格式，请参阅在 Google Chat 应用中设置文本格式和在 Google Workspace 插件中设置文本格式。

contentMultiline

boolean

内容是否为多行内容。

bottomLabel

string

底部标签的文本。支持带格式的文本。如需详细了解如何设置文本格式，请参阅在 Google Chat 应用中设置文本格式和在 Google Workspace 插件中设置文本格式。

onClick

object (OnClick)

onclick 操作。只有顶部标签、底部标签和内容区域可供点击。

联合字段 icons。必须至少定义一个图标 top_label 和 bottom_label。icons 只能是下列其中一项：
icon

enum (Icon)

由 Chat API 替换为相应的图标图片的枚举值。

iconUrl

string

由网址指定的图标。

联合字段 control。一个控件微件。您可以设置 button 或 switch_widget，但不能同时设置两者。 control 只能是下列其中一项：
button

object (Button)

可触发操作的按钮。

图标

受支持的图标集。

枚举
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

按钮

一个按钮。可以是文本按钮或图片按钮。

JSON 表示法 
{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
字段

联合字段 type。

type 只能是下列其中一项：

textButton

object (TextButton)

一个包含文本和 onclick 操作的按钮。

imageButton

object (ImageButton)

一个包含图片和 onclick 操作的按钮。

文本按钮

一个包含文本和 onclick 操作的按钮。

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

string

按钮的文本。

onClick

object (OnClick)

按钮的 onclick 操作。

ImageButton

包含 onclick 操作的图片按钮。

JSON 表示法 
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
字段
onClick

object (OnClick)

onclick 操作。
name

string

此 imageButton 的名称，用于提供无障碍功能。如果未指定此名称，系统将提供默认值。

联合字段 icons。图标可以由 Icon enum 或网址指定。icons 只能是下列其中一项：
icon

enum (Icon)

由 enum 指定的图标，指向 Chat API 提供的图标。

iconUrl

string

由网址指定的图标。

CardAction

卡片操作是与卡片相关联的操作。对于账单卡片，典型的操作是：删除账单、通过电子邮件发送账单或在浏览器中打开账单。

不支持 Google Chat 应用。

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

string

过去在操作菜单项中显示的标签。
onClick

object (OnClick)

此操作对象的 onClick 操作。