Ações do Gmail

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Os objetos Action permitem que você crie um 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 IU de complementos.

Uma ação é anexada a um determinado widget usando uma função de gerenciador 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 lado do cliente pelo usuário. 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 exiba um novo cartão quando clicado. Para isso, é necessário criar um novo widget de botão e usar a função gerenciador de widgets setOnClickAction(action) para definir uma criação de cards Action. 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 desejado e retorna um objeto ActionResponse. O objeto de resposta instrui o complemento a exibir o cartão que a função de callback criou.

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

Interações no Gmail

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

Tentativa de ação A função de retorno de chamada deve retornar
Escrever rascunhos de mensagens ComposeActionResponse

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

Escrever mensagem

Um complemento do Google Workspace que estende o Gmail pode definir um widget que, ao interagir, gera mensagens de rascunho no Gmail (novas mensagens ou respostas). Para fazer isso, você precisa associar o widget de acionamento a uma função de callback que retorne um objeto ComposeActionResponse. Quando a função de callback terminar a execução, o Gmail usará esse objeto de resposta para abrir e preencher uma janela de texto de rascunho.

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