Icon

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

支持内置和自定义图标。

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

JSON 表示法 
{
  "altText": string,
  "imageType": enum (ImageType),

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
字段
altText

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 会被忽略。
imageType

enum (ImageType)

应用于图片的剪裁样式。在某些情况下，应用 CIRCLE 剪裁会导致绘制的图片大于内置图标。
卡片上的 widget 中显示的图标。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
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 Fonts Icons，然后调整自定义下的设置。
weight

integer

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

如需预览不同的图标设置，请前往 Google Fonts Icons，然后调整自定义下的设置。
grade

integer

Weight 和 Grade 会影响符号的粗细。与对粗细的调整相比，对等级的调整更加精细，并且对符号大小的影响较小。从 {-25, 0, 200} 中选择。如果不存在，则默认值为 0。如果指定了任何其他值，则使用默认值。

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