Os objetos Action permitem criar objetos
nos complementos do Google Workspace. Eles definem
o que acontece quando um usuário interage com um widget (por exemplo, um botão)
a interface do complemento.
Uma ação é anexada a um widget específico usando um função de gerenciador de widget, que também define a condição que desencadeia a ação. Quando ele é acionado, uma determinada ação executa função de callback. A função de retorno de chamada recebe um objeto de evento que carrega informações sobre as interações do usuário no lado do cliente. É necessário implementar o callback da função e fazer com que ela retorne um objeto de resposta específico.
Por exemplo, digamos que você queira um botão que crie e exiba um novo card quando
clicado. Para isso, você precisa criar um novo widget de botão e usar o de botões.
função do gerenciador
setOnClickAction(action)
para definir um Action de criação de cards. A
O Action que você define especifica um Apps Script
função de callback que é executada quando o botão é clicado. Nesse caso,
implementar a função de retorno de chamada para criar o cartão que você deseja e retornar um
ActionResponse
objeto. O objeto de resposta instrui o complemento a exibir o cartão que o callback
função criada.
Esta página descreve ações de widget específicas do Gmail que você pode incluir em sua .
Interações do Gmail
Os complementos do Google Workspace que ampliam o Gmail podem incluir uma ação de widget específica do Gmail para escrever mensagens de rascunho. Isso requer uma ação associada função de callback para retornar 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 de widget e objetos de resposta, o complemento precisa
incluem o parâmetro
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope no manifesto.
Escreva uma mensagem
Um complemento do Google Workspace que amplia o Gmail pode
definir um widget que, quando houver interação, gera rascunhos de mensagens no Gmail
(novas mensagens ou respostas). Para isso, associe o acionamento
com uma função de callback que retorna um
ComposeActionResponse
objeto. Quando a execução da função de callback é concluída, o Gmail usa este
objeto de resposta para abrir e preencher uma janela de texto de rascunho.
Para mais detalhes e um exemplo, consulte Escrever rascunhos de mensagens.