Como estender o Gmail com complementos do Google Workspace

O objetivo de muitos e-mails é fazer com que o destinatário realize uma tarefa específica ou alcance uma meta, como adicionar um evento à agenda, preencher um formulário, fazer uma reserva ou usar outros aplicativos. No entanto, os destinatários precisam concluir a tarefa sem mais comandos, geralmente realizando várias etapas manuais.

Você pode economizar tempo e esforço dos usuários automatizando essas tarefas com Complementos do Google Workspace. Quando um usuário lê ou escreve uma mensagem no Gmail, um complemento do Google Workspace pode apresentar uma interface interativa e personalizada que permite que o usuário interaja com a mensagem de várias maneiras, como:

  • exibir mais informações para o usuário na interface do Gmail;
  • conectar-se a serviços que não são do Google para buscar informações ou realizar outras ações;
  • oferecer meios para controlar o comportamento do complemento ou enviar informações a outro serviço.

Os complementos do Google Workspace podem definir os seguintes tipos de extensões no Gmail:

Além disso, os complementos do Google Workspace que estendem o Gmail fazem isso em clientes para computador e dispositivos móveis.

Páginas iniciais do Gmail

O Gmail é compatível com a exibição das páginas iniciais dos complementos do Google Workspace. Para mostrar a página inicial comum do complemento no Gmail, verifique se há um campo addOns.gmail no manifesto do complemento.

Como alternativa, adicione um gmail.homepageTrigger ao manifesto do complemento para fornecer uma página inicial específica do Gmail.

Em qualquer caso, você precisa fornecer o nome de uma função de gatilho da página inicial no projeto de script do complemento. Essa função é chamada automaticamente para criar a página inicial do Gmail quando necessário. Você precisa implementar essa função para criar e retornar um único Card ou uma matriz de objetos Card que compõem a página inicial. A função de acionamento da página inicial recebe um objeto de evento como um parâmetro que contém algumas informações gerais, como a plataforma do cliente. É possível usar os dados do objeto de evento para personalizar a construção da página inicial.

Confira o que você pode criar

Os complementos do Google Workspace são criados usando o Apps Script, e as interfaces são definidas com o serviço de card do Apps Script. Confira uma visão geral em Como criar complementos do Google Workspace. O comportamento dos complementos do Google Workspace é configurado usando um manifesto, que inclui seções específicas do Gmail.

Ao configurar seu complemento do Google Workspace para estender o Gmail, você precisa decidir quais interfaces criar para o complemento e quais ações ele pode realizar. Consulte os guias a seguir para mais informações: