Cards v1

Карта

Карточка — это элемент пользовательского интерфейса, который может содержать такие виджеты пользовательского интерфейса, как текст и изображения.

Представление JSON
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Поля
header

object ( CardHeader )

Заголовок карты. Заголовок обычно содержит заголовок и изображение.

sections[]

object ( Section )

Секции разделены разделителем строк.

cardActions[]

object ( CardAction )

Действия этой карты.

name

string

Название карты.

Заголовок карты

Представление JSON
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
Поля
title

string

Должно быть указано название. Заголовок имеет фиксированную высоту: если указаны и заголовок, и подзаголовок, каждый из них занимает одну строку. Если указано только название, оно занимает обе строки.

subtitle

string

Подзаголовок заголовка карточки.

imageStyle

enum ( ImageStyle )

Тип изображения (например, квадратная рамка или круглая рамка).

imageUrl

string

URL изображения в шапке карточки.

Стиль изображения

перечисления
IMAGE_STYLE_UNSPECIFIED
IMAGE Квадратный бордюр.
AVATAR Круглая граница.

Раздел

Раздел содержит набор виджетов, отображаемых (по вертикали) в том порядке, в котором они указаны. На всех платформах карточки имеют узкую фиксированную ширину, поэтому в настоящее время нет необходимости в свойствах макета (например, обтекание).

Представление JSON
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
Поля
header

string

Заголовок раздела. Поддерживается форматированный текст. Дополнительные сведения о форматировании текста см. в разделах Форматирование текста в приложениях Google Chat и Форматирование текста в надстройках Google Workspace .

widgets[]

object ( WidgetMarkup )

Раздел должен содержать хотя бы один виджет.

Разметка виджета

Виджет — это элемент пользовательского интерфейса, который представляет текст и изображения.

Представление 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 )

Отображение ключевого элемента значения в этом виджете.

Текстовый Параграф

Абзац текста. Поддерживается форматированный текст. Дополнительные сведения о форматировании текста см. в разделах Форматирование текста в приложениях Google Chat и Форматирование текста в надстройках Google Workspace .

Представление JSON
{
  "text": string
}
Поля
text

string

Изображение

Изображение, указанное с помощью URL-адреса, которое может иметь действие onclick .

Представление JSON
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
Поля
imageUrl

string

URL-адрес изображения.

onClick

object ( OnClick )

Действие onclick .

aspectRatio

number

Соотношение сторон этого изображения (ширина и высота). Это поле позволяет вам зарезервировать правильную высоту для изображения, ожидая его загрузки. Он не предназначен для переопределения встроенного соотношения сторон изображения. Если не установлено, сервер заполняет его путем предварительной загрузки изображения.

По щелчку

Действие 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 , если оно указано.

ФормаДействие

Действие формы описывает поведение при отправке формы. Например, вы можете вызвать скрипт приложений для обработки формы.

Представление JSON
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
Поля
actionMethodName

string

Имя метода используется для определения того, какая часть формы вызвала отправку формы. Эта информация передается обратно в приложение Chat как часть события щелчка карты. Вы можете использовать одно и то же имя метода для нескольких элементов, которые вызывают общее поведение.

parameters[]

object ( 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

Значок, заданный URL-адресом.

Союз полевой 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 .

Кнопка изображения

Кнопка изображения с действием 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 поля союза. Значок может быть указан с помощью enum Icon или URL-адреса. icons могут быть только одним из следующих:
icon

enum ( Icon )

Значок, указанный enum , которое указывает на значок, предоставленный Chat API.

iconUrl

string

Значок, заданный URL-адресом.

CardAction

Действие карты — это действие, связанное с картой. Для карточки счета типичным действием будет: удалить счет, отправить счет по электронной почте или открыть счет в браузере.

Не поддерживается приложениями Google Chat.

Представление JSON
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
Поля
actionLabel

string

Метка раньше отображалась в пункте меню действий.

onClick

object ( OnClick )

Действие по щелчку для этого элемента действия.