Объекты Action позволяют встраивать интерактивное поведение в надстройки Google Workspace. Они определяют, что происходит, когда пользователь взаимодействует с виджетом (например, кнопкой) в пользовательском интерфейсе надстройки.
Действие прикрепляется к данному виджету с помощью функции-обработчика виджета , которая также определяет условие, запускающее действие. При срабатывании действие выполняет назначенную функцию обратного вызова . В функцию обратного вызова передается объект события , который содержит информацию о взаимодействиях пользователя на стороне клиента. Вы должны реализовать функцию обратного вызова и заставить ее возвращать определенный объект ответа.
Например, предположим, что вам нужна кнопка, которая создает и отображает новую карточку при нажатии. Для этого вам необходимо создать новый виджет кнопки и использовать функцию обработчика виджета кнопки setOnClickAction(action) чтобы установить Action для создания карты. Определяемое вами Action определяет функцию обратного вызова Apps Script, которая выполняется при нажатии кнопки. В этом случае вы реализуете функцию обратного вызова для создания нужной карты и возвращаете объект ActionResponse . Объект ответа сообщает надстройке отобразить карточку, созданную функцией обратного вызова.
На этой странице описаны действия виджета, специфичные для Gmail, которые вы можете включить в свое дополнение.
Взаимодействие с Gmail
Дополнения Google Workspace, расширяющие Gmail, могут включать дополнительное действие виджета, специфичное для Gmail, для создания черновиков сообщений. Это действие требует, чтобы соответствующая функция обратного вызова действия возвращала специализированный объект ответа:
| Предпринято действие | Функция обратного вызова должна вернуться |
|---|---|
| Создание черновиков сообщений | ComposeActionResponse |
Чтобы использовать эти действия виджета и объекты ответов, надстройка должна включить в свой манифест область https://www.googleapis.com/auth/gmail.addons.current.action.compose .
Написать сообщение
Надстройка Google Workspace, расширяющая Gmail, может определять виджет, который при взаимодействии с ним генерирует черновики сообщений в Gmail (новые сообщения или ответы). Для этого необходимо связать триггерный виджет с функцией обратного вызова, которая возвращает объект ComposeActionResponse . Когда функция обратного вызова завершает выполнение, Gmail использует этот объект ответа, чтобы открыть и заполнить окно создания черновика.
Дополнительные сведения и пример см. в разделе Создание черновиков сообщений .