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