Действия в Gmail

Объекты 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 использует этот объект ответа, чтобы открыть и заполнить окно создания черновика.

Дополнительные сведения и пример см. в разделе Создание черновиков сообщений .