ImageButton
с отображаемым на нем изображением.
Доступно для дополнений Google Workspace и приложений Google Chat.
const imageButton = CardService.newImageButton() .setAltText('An image button with an airplane icon.') .setIcon(CardService.Icon.AIRPLANE) .setOpenLink(CardService.newOpenLink().setUrl('https://airplane.com'));
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
setAltText(altText) | ImageButton | Устанавливает альтернативный текст кнопки для специальных возможностей. |
setAuthorizationAction(action) | ImageButton | Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. |
setComposeAction(action, composedEmailType) | ImageButton | Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. |
setIcon(icon) | ImageButton | Устанавливает предопределенный Icon для отображения на кнопке. |
setIconUrl(url) | ImageButton | Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. |
setImageButtonStyle(imageButtonStyle) | ImageButton | Устанавливает стиль кнопки. |
setMaterialIcon(icon) | ImageButton | Устанавливает значок дизайна материала. |
setOnClickAction(action) | ImageButton | Устанавливает действие, которое выполняется при щелчке объекта. |
setOnClickOpenLinkAction(action) | ImageButton | Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. |
setOpenLink(openLink) | ImageButton | Устанавливает URL-адрес, который будет открываться при нажатии на объект. |
setOverflowMenu(menu) | ImageButton | Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. |
Подробная документация
setAltText(altText)
Устанавливает альтернативный текст кнопки для специальных возможностей. Необходимый.
Параметры
Имя | Тип | Описание |
---|---|---|
altText | String | Альтернативный текст, который можно назначить этой кнопке. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setAuthorizationAction(action)
Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. URL-адрес откроется в новом окне. Когда пользователь завершает процесс авторизации и возвращается в приложение, надстройка перезагружается.
Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Параметры
Имя | Тип | Описание |
---|---|---|
action | AuthorizationAction | Объект, определяющий действие авторизации, которое необходимо выполнить при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setComposeAction(action, composedEmailType)
Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ComposeActionResponse
, настроенный с помощью ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие создания, выполняемое при щелчке этого элемента. |
composedEmailType | ComposedEmailType | Значение перечисления, указывающее, является ли составленный черновик автономным или черновиком ответа. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIcon(icon)
Устанавливает предопределенный Icon
для отображения на кнопке. Либо это, либо setIconUrl(url)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
icon | Icon | Одно из предопределенных значений Icon . |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIconUrl(url)
Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. Либо это, либо setIcon(icon)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
url | String | URL-адрес размещенного изображения, которое будет использоваться в качестве значка этой кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setImageButtonStyle(imageButtonStyle)
Устанавливает стиль кнопки. Если этот параметр не установлен, по умолчанию используется кнопка ImageButtonStyle.BORDERLESS
.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const imageButton = CardService.newImageButton().setImageButtonStyle( CardService.ImageButtonStyle.BORDERLESS, );
Параметры
Имя | Тип | Описание |
---|---|---|
imageButtonStyle | ImageButtonStyle | Стиль кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setMaterialIcon(icon)
Устанавливает значок дизайна материала.
const imageButton = CardService.newImageButton().setMaterialIcon( CardService.newMaterialIcon().setName('search'), );
Параметры
Имя | Тип | Описание |
---|---|---|
icon | MaterialIcon | Значок дизайна материала. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickAction(action)
Устанавливает действие, которое выполняется при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
.
// ... const action = CardService.newAction().setFunctionName('notificationCallback'); CardService.newTextButton() .setText('Create notification') .setOnClickAction(action); // ... function notificationCallback() { return CardService.newActionResponseBuilder() .setNotification( CardService.newNotification().setText('Some info to display to user'), ) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Действие, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickOpenLinkAction(action)
Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. Используйте эту функцию, когда URL-адрес необходимо создать или когда вам нужно выполнить другие действия помимо создания объекта OpenLink
. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
, настроенный с помощью ActionResponseBuilder.setOpenLink(openLink)
.
// ... const action = CardService.newAction().setFunctionName('openLinkCallback'); CardService.newTextButton() .setText('Open Link') .setOnClickOpenLinkAction(action); // ... function openLinkCallback() { return CardService.newActionResponseBuilder() .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com')) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие открытия ссылки, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOpenLink(openLink)
Устанавливает URL-адрес, который будет открываться при нажатии на объект. Используйте эту функцию, когда URL-адрес уже известен и его нужно только открыть. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметры
Имя | Тип | Описание |
---|---|---|
openLink | OpenLink | Объект OpenLink описывающий открываемый URL-адрес. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOverflowMenu(menu)
Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. Для каждого элемента меню можно указать действие, которое будет запускаться при нажатии. Вложенные меню не поддерживаются, действия для пунктов меню не должны указывать меню переполнения.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
Параметры
Имя | Тип | Описание |
---|---|---|
menu | OverflowMenu | Объект, определяющий меню переполнения, отображаемое при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
ImageButton
с отображаемым на нем изображением.
Доступно для дополнений Google Workspace и приложений Google Chat.
const imageButton = CardService.newImageButton() .setAltText('An image button with an airplane icon.') .setIcon(CardService.Icon.AIRPLANE) .setOpenLink(CardService.newOpenLink().setUrl('https://airplane.com'));
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
setAltText(altText) | ImageButton | Устанавливает альтернативный текст кнопки для специальных возможностей. |
setAuthorizationAction(action) | ImageButton | Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. |
setComposeAction(action, composedEmailType) | ImageButton | Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. |
setIcon(icon) | ImageButton | Устанавливает предопределенный Icon для отображения на кнопке. |
setIconUrl(url) | ImageButton | Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. |
setImageButtonStyle(imageButtonStyle) | ImageButton | Устанавливает стиль кнопки. |
setMaterialIcon(icon) | ImageButton | Устанавливает значок дизайна материала. |
setOnClickAction(action) | ImageButton | Устанавливает действие, которое выполняется при щелчке объекта. |
setOnClickOpenLinkAction(action) | ImageButton | Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. |
setOpenLink(openLink) | ImageButton | Устанавливает URL-адрес, который будет открываться при нажатии на объект. |
setOverflowMenu(menu) | ImageButton | Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. |
Подробная документация
setAltText(altText)
Устанавливает альтернативный текст кнопки для специальных возможностей. Необходимый.
Параметры
Имя | Тип | Описание |
---|---|---|
altText | String | Альтернативный текст, который можно назначить этой кнопке. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setAuthorizationAction(action)
Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. URL-адрес откроется в новом окне. Когда пользователь завершает процесс авторизации и возвращается в приложение, надстройка перезагружается.
Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Параметры
Имя | Тип | Описание |
---|---|---|
action | AuthorizationAction | Объект, определяющий действие авторизации, которое необходимо выполнить при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setComposeAction(action, composedEmailType)
Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ComposeActionResponse
, настроенный с помощью ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие создания, выполняемое при щелчке этого элемента. |
composedEmailType | ComposedEmailType | Значение перечисления, указывающее, является ли составленный черновик автономным или черновиком ответа. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIcon(icon)
Устанавливает предопределенный Icon
для отображения на кнопке. Либо это, либо setIconUrl(url)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
icon | Icon | Одно из предопределенных значений Icon . |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIconUrl(url)
Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. Либо это, либо setIcon(icon)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
url | String | URL-адрес размещенного изображения, которое будет использоваться в качестве значка этой кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setImageButtonStyle(imageButtonStyle)
Устанавливает стиль кнопки. Если этот параметр не установлен, по умолчанию используется кнопка ImageButtonStyle.BORDERLESS
.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const imageButton = CardService.newImageButton().setImageButtonStyle( CardService.ImageButtonStyle.BORDERLESS, );
Параметры
Имя | Тип | Описание |
---|---|---|
imageButtonStyle | ImageButtonStyle | Стиль кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setMaterialIcon(icon)
Устанавливает значок дизайна материала.
const imageButton = CardService.newImageButton().setMaterialIcon( CardService.newMaterialIcon().setName('search'), );
Параметры
Имя | Тип | Описание |
---|---|---|
icon | MaterialIcon | Значок дизайна материала. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickAction(action)
Устанавливает действие, которое выполняется при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
.
// ... const action = CardService.newAction().setFunctionName('notificationCallback'); CardService.newTextButton() .setText('Create notification') .setOnClickAction(action); // ... function notificationCallback() { return CardService.newActionResponseBuilder() .setNotification( CardService.newNotification().setText('Some info to display to user'), ) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Действие, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickOpenLinkAction(action)
Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. Используйте эту функцию, когда URL-адрес необходимо создать или когда вам нужно выполнить другие действия помимо создания объекта OpenLink
. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
, настроенный с помощью ActionResponseBuilder.setOpenLink(openLink)
.
// ... const action = CardService.newAction().setFunctionName('openLinkCallback'); CardService.newTextButton() .setText('Open Link') .setOnClickOpenLinkAction(action); // ... function openLinkCallback() { return CardService.newActionResponseBuilder() .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com')) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие открытия ссылки, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOpenLink(openLink)
Устанавливает URL-адрес, который будет открываться при нажатии на объект. Используйте эту функцию, когда URL-адрес уже известен и его нужно только открыть. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметры
Имя | Тип | Описание |
---|---|---|
openLink | OpenLink | Объект OpenLink описывающий открываемый URL-адрес. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOverflowMenu(menu)
Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. Для каждого элемента меню можно указать действие, которое будет запускаться при нажатии. Вложенные меню не поддерживаются, действия для пунктов меню не должны указывать меню переполнения.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
Параметры
Имя | Тип | Описание |
---|---|---|
menu | OverflowMenu | Объект, определяющий меню переполнения, отображаемое при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
ImageButton
с отображаемым на нем изображением.
Доступно для дополнений Google Workspace и приложений Google Chat.
const imageButton = CardService.newImageButton() .setAltText('An image button with an airplane icon.') .setIcon(CardService.Icon.AIRPLANE) .setOpenLink(CardService.newOpenLink().setUrl('https://airplane.com'));
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
setAltText(altText) | ImageButton | Устанавливает альтернативный текст кнопки для специальных возможностей. |
setAuthorizationAction(action) | ImageButton | Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. |
setComposeAction(action, composedEmailType) | ImageButton | Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. |
setIcon(icon) | ImageButton | Устанавливает предопределенный Icon для отображения на кнопке. |
setIconUrl(url) | ImageButton | Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. |
setImageButtonStyle(imageButtonStyle) | ImageButton | Устанавливает стиль кнопки. |
setMaterialIcon(icon) | ImageButton | Устанавливает значок дизайна материала. |
setOnClickAction(action) | ImageButton | Устанавливает действие, которое выполняется при щелчке объекта. |
setOnClickOpenLinkAction(action) | ImageButton | Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. |
setOpenLink(openLink) | ImageButton | Устанавливает URL-адрес, который будет открываться при нажатии на объект. |
setOverflowMenu(menu) | ImageButton | Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. |
Подробная документация
setAltText(altText)
Устанавливает альтернативный текст кнопки для специальных возможностей. Необходимый.
Параметры
Имя | Тип | Описание |
---|---|---|
altText | String | Альтернативный текст, который можно назначить этой кнопке. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setAuthorizationAction(action)
Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. URL-адрес откроется в новом окне. Когда пользователь завершает процесс авторизации и возвращается в приложение, надстройка перезагружается.
Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Параметры
Имя | Тип | Описание |
---|---|---|
action | AuthorizationAction | Объект, определяющий действие авторизации, которое необходимо выполнить при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setComposeAction(action, composedEmailType)
Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ComposeActionResponse
, настроенный с помощью ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие создания, выполняемое при щелчке этого элемента. |
composedEmailType | ComposedEmailType | Значение перечисления, указывающее, является ли составленный черновик автономным или черновиком ответа. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIcon(icon)
Устанавливает предопределенный Icon
для отображения на кнопке. Либо это, либо setIconUrl(url)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
icon | Icon | Одно из предопределенных значений Icon . |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIconUrl(url)
Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. Либо это, либо setIcon(icon)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
url | String | URL-адрес размещенного изображения, которое будет использоваться в качестве значка этой кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setImageButtonStyle(imageButtonStyle)
Устанавливает стиль кнопки. Если этот параметр не установлен, по умолчанию используется кнопка ImageButtonStyle.BORDERLESS
.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const imageButton = CardService.newImageButton().setImageButtonStyle( CardService.ImageButtonStyle.BORDERLESS, );
Параметры
Имя | Тип | Описание |
---|---|---|
imageButtonStyle | ImageButtonStyle | Стиль кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setMaterialIcon(icon)
Устанавливает значок дизайна материала.
const imageButton = CardService.newImageButton().setMaterialIcon( CardService.newMaterialIcon().setName('search'), );
Параметры
Имя | Тип | Описание |
---|---|---|
icon | MaterialIcon | Значок дизайна материала. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickAction(action)
Устанавливает действие, которое выполняется при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
.
// ... const action = CardService.newAction().setFunctionName('notificationCallback'); CardService.newTextButton() .setText('Create notification') .setOnClickAction(action); // ... function notificationCallback() { return CardService.newActionResponseBuilder() .setNotification( CardService.newNotification().setText('Some info to display to user'), ) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Действие, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickOpenLinkAction(action)
Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. Используйте эту функцию, когда URL-адрес необходимо создать или когда вам нужно выполнить другие действия помимо создания объекта OpenLink
. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
, настроенный с помощью ActionResponseBuilder.setOpenLink(openLink)
.
// ... const action = CardService.newAction().setFunctionName('openLinkCallback'); CardService.newTextButton() .setText('Open Link') .setOnClickOpenLinkAction(action); // ... function openLinkCallback() { return CardService.newActionResponseBuilder() .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com')) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие открытия ссылки, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOpenLink(openLink)
Устанавливает URL-адрес, который будет открываться при нажатии на объект. Используйте эту функцию, когда URL-адрес уже известен и его нужно только открыть. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметры
Имя | Тип | Описание |
---|---|---|
openLink | OpenLink | Объект OpenLink описывающий открываемый URL-адрес. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOverflowMenu(menu)
Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. Для каждого элемента меню можно указать действие, которое будет запускаться при нажатии. Вложенные меню не поддерживаются, действия для пунктов меню не должны указывать меню переполнения.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
Параметры
Имя | Тип | Описание |
---|---|---|
menu | OverflowMenu | Объект, определяющий меню переполнения, отображаемое при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
ImageButton
с отображаемым на нем изображением.
Доступно для дополнений Google Workspace и приложений Google Chat.
const imageButton = CardService.newImageButton() .setAltText('An image button with an airplane icon.') .setIcon(CardService.Icon.AIRPLANE) .setOpenLink(CardService.newOpenLink().setUrl('https://airplane.com'));
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
setAltText(altText) | ImageButton | Устанавливает альтернативный текст кнопки для специальных возможностей. |
setAuthorizationAction(action) | ImageButton | Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. |
setComposeAction(action, composedEmailType) | ImageButton | Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. |
setIcon(icon) | ImageButton | Устанавливает предопределенный Icon для отображения на кнопке. |
setIconUrl(url) | ImageButton | Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. |
setImageButtonStyle(imageButtonStyle) | ImageButton | Устанавливает стиль кнопки. |
setMaterialIcon(icon) | ImageButton | Устанавливает значок дизайна материала. |
setOnClickAction(action) | ImageButton | Устанавливает действие, которое выполняется при щелчке объекта. |
setOnClickOpenLinkAction(action) | ImageButton | Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. |
setOpenLink(openLink) | ImageButton | Устанавливает URL-адрес, который будет открываться при нажатии на объект. |
setOverflowMenu(menu) | ImageButton | Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. |
Подробная документация
setAltText(altText)
Устанавливает альтернативный текст кнопки для специальных возможностей. Необходимый.
Параметры
Имя | Тип | Описание |
---|---|---|
altText | String | Альтернативный текст, который можно назначить этой кнопке. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setAuthorizationAction(action)
Устанавливает действие авторизации, которое открывает URL-адрес потока авторизации при щелчке объекта. URL-адрес откроется в новом окне. Когда пользователь завершает процесс авторизации и возвращается в приложение, надстройка перезагружается.
Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Параметры
Имя | Тип | Описание |
---|---|---|
action | AuthorizationAction | Объект, определяющий действие авторизации, которое необходимо выполнить при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setComposeAction(action, composedEmailType)
Устанавливает действие, которое формирует черновик электронного письма при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ComposeActionResponse
, настроенный с помощью ComposeActionResponseBuilder.setGmailDraft(draft)
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие создания, выполняемое при щелчке этого элемента. |
composedEmailType | ComposedEmailType | Значение перечисления, указывающее, является ли составленный черновик автономным или черновиком ответа. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIcon(icon)
Устанавливает предопределенный Icon
для отображения на кнопке. Либо это, либо setIconUrl(url)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
icon | Icon | Одно из предопределенных значений Icon . |
Возвращаться
ImageButton
— Этот объект для цепочки.
setIconUrl(url)
Устанавливает URL-адрес изображения, которое будет использоваться в качестве значка этой кнопки. Либо это, либо setIcon(icon)
необходимо использовать для определения изображения кнопки.
Параметры
Имя | Тип | Описание |
---|---|---|
url | String | URL-адрес размещенного изображения, которое будет использоваться в качестве значка этой кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setImageButtonStyle(imageButtonStyle)
Устанавливает стиль кнопки. Если этот параметр не установлен, по умолчанию используется кнопка ImageButtonStyle.BORDERLESS
.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const imageButton = CardService.newImageButton().setImageButtonStyle( CardService.ImageButtonStyle.BORDERLESS, );
Параметры
Имя | Тип | Описание |
---|---|---|
imageButtonStyle | ImageButtonStyle | Стиль кнопки. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setMaterialIcon(icon)
Устанавливает значок дизайна материала.
const imageButton = CardService.newImageButton().setMaterialIcon( CardService.newMaterialIcon().setName('search'), );
Параметры
Имя | Тип | Описание |
---|---|---|
icon | MaterialIcon | Значок дизайна материала. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickAction(action)
Устанавливает действие, которое выполняется при щелчке объекта. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
.
// ... const action = CardService.newAction().setFunctionName('notificationCallback'); CardService.newTextButton() .setText('Create notification') .setOnClickAction(action); // ... function notificationCallback() { return CardService.newActionResponseBuilder() .setNotification( CardService.newNotification().setText('Some info to display to user'), ) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Действие, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOnClickOpenLinkAction(action)
Устанавливает действие, которое открывает URL-адрес на вкладке при щелчке объекта. Используйте эту функцию, когда URL-адрес необходимо создать или когда вам нужно выполнить другие действия помимо создания объекта OpenLink
. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметр Action
должен указывать функцию обратного вызова, которая возвращает объект ActionResponse
, настроенный с помощью ActionResponseBuilder.setOpenLink(openLink)
.
// ... const action = CardService.newAction().setFunctionName('openLinkCallback'); CardService.newTextButton() .setText('Open Link') .setOnClickOpenLinkAction(action); // ... function openLinkCallback() { return CardService.newActionResponseBuilder() .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com')) .build(); }
Параметры
Имя | Тип | Описание |
---|---|---|
action | Action | Объект, определяющий действие открытия ссылки, которое необходимо выполнить при щелчке по этому элементу. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOpenLink(openLink)
Устанавливает URL-адрес, который будет открываться при нажатии на объект. Используйте эту функцию, когда URL-адрес уже известен и его нужно только открыть. Объект пользовательского интерфейса может иметь только один из setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
или setComposeAction(action, composedEmailType)
.
Параметры
Имя | Тип | Описание |
---|---|---|
openLink | OpenLink | Объект OpenLink описывающий открываемый URL-адрес. |
Возвращаться
ImageButton
— Этот объект для цепочки.
setOverflowMenu(menu)
Устанавливает всплывающее меню, которое будет открываться при щелчке объекта. Для каждого элемента меню можно указать действие, которое будет запускаться при нажатии. Вложенные меню не поддерживаются, действия для пунктов меню не должны указывать меню переполнения.
Доступно только для приложений Google Chat. Недоступно для дополнений Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
Параметры
Имя | Тип | Описание |
---|---|---|
menu | OverflowMenu | Объект, определяющий меню переполнения, отображаемое при щелчке этого элемента. |
Возвращаться
ImageButton
— Этот объект для цепочки.