Ações do Gmail

Os objetos Action permitem criar comportamento interativo nos complementos do Google Workspace. Eles definem o que acontece quando um usuário interage com um widget (por exemplo, um botão) na interface do complemento.

Uma ação é anexada a um widget usando uma função de manipulador de widgets, que também define a condição que aciona a ação. Quando acionada, a ação executa uma função de callback designada. A função de callback recebe um objeto de evento que carrega informações sobre as interações do usuário no lado do cliente. É necessário implementar a função de callback e fazer com que ela retorne um objeto de resposta específico.

Por exemplo, digamos que você queira um botão que crie e mostre um novo card quando clicado. Para isso, crie um novo widget de botão e use a função de manipulador do widget de botão setOnClickAction(action) para definir um Action de criação de cards. O Action que você define especifica uma função de callback do Apps Script que é executada quando o botão é clicado. Nesse caso, você implementa a função de callback para criar o card que você quer e retornar um objeto ActionResponse. O objeto de resposta informa ao complemento para mostrar o card que a função de callback criou.

Esta página descreve as ações de widgets específicas do Gmail que você pode incluir no complemento.

Interações com o Gmail

Os complementos do Google Workspace que estendem o Gmail podem incluir uma ação de widget específica do Gmail para escrever mensagens de rascunho. Essa ação exige que a função de callback associada à ação retorne um objeto de resposta especializado:

Tentativa de ação	A função de callback precisa retornar
Escrever rascunhos de mensagens	ComposeActionResponse

Para usar essas ações e objetos de resposta do widget, o complemento precisa incluir o escopo https://www.googleapis.com/auth/gmail.addons.current.action.compose no manifesto.

Escreva uma mensagem

Um complemento do Google Workspace que estende o Gmail pode definir um widget que, quando interagido, gera mensagens de rascunho no Gmail (novas mensagens ou respostas). Para fazer isso, você precisa associar o widget acionado a uma função de callback que retorna um objeto ComposeActionResponse. Quando a função de callback termina de ser executada, o Gmail usa esse objeto de resposta para abrir e preencher uma janela de composição de rascunho.

Para mais detalhes e um exemplo, consulte Escrever mensagens de rascunho.