Объекты 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 использует этот объект ответа для открытия и заполнения окна черновика для написания сообщения.
Более подробную информацию и пример см. в разделе Создание черновиков сообщений .