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 изображение может быть больше, чем встроенный значок.

Значок, который показывается в виджете на карточке. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
knownIcon

string

Показывать один из встроенных значков, предоставляемых Google Workspace.

Например, чтобы показать значок самолета, укажите AIRPLANE. Для автобуса укажите BUS.

Полный список поддерживаемых значков можно найти в разделе Встроенные значки.

iconUrl

string

Показывать пользовательский значок, размещенный по URL с протоколом HTTPS.

Пример:

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

Поддерживаемые типы файлов: .png и .jpg.

materialIcon

object (MaterialIcon)

Показывает один из значков Material Design от Google.

Например, чтобы показать значок флажка, используйте

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

Доступно для приложений Google Chat и недоступно для дополнений Google Workspace.

Конец взаимоисключающих полей.

MaterialIcon

Значок Material Design от Google (доступно более 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

Название значка, определенное в значок Material Design Google, например check_box. Недопустимые названия игнорируются и заменяются пустой строкой, в результате чего значок не отображается.

fill

boolean

Определяет, будет ли значок закрашен. Значение по умолчанию – false.

Чтобы посмотреть, как будут выглядеть значки с разными настройками, перейдите на страницу 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 (Настройка).