Os objetos Action permitem criar um comportamento interativo
em 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 determinado widget usando uma função de handler de widget, 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 contém informações sobre as interações do usuário no lado do cliente. Você precisa 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 handler
setOnClickAction(action)
para definir uma Action de criação de card. A
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 desejado e retornar um
ActionResponse
objeto. O objeto de resposta informa ao complemento para mostrar o card criado pela função de callback.
Esta página descreve as ações de widget específicas do Gmail que podem ser incluídas no complemento.
Interações do Gmail
Os complementos do Google Workspace que estendem o Gmail podem incluir uma ação de widget específica do Gmail para criar mensagens de rascunho. Essa ação exige que a função de callback de ação associada retorne um objeto de resposta especializado:
| Ação tentada | A função de callback precisa retornar |
|---|---|
| Criar mensagens de rascunho | ComposeActionResponse |
Para usar essas ações de widget e objetos de resposta, o
complemento do Google Workspace precisa incluir o
https://www.googleapis.com/auth/gmail.addons.current.action.compose
escopo no
manifesto.
Escreva uma mensagem
Os complementos que estendem o Gmail podem definir um widget que, quando interagido, gera mensagens de rascunho no Gmail (novas mensagens ou respostas). Para fazer isso,ys
associe o widget de acionamento a uma função de callback que retorna um
ComposeActionResponse
objeto. Quando a função de callback termina a execução, o Gmail usa esse objeto de resposta para abrir e preencher uma janela de texto de rascunho.
Para mais detalhes e um exemplo, consulte Criar mensagens de rascunho.