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 solicitações, muitas vezes realizando várias etapas manuais.

É possível economizar tempo e esforço para os 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;
  • Fornecer meios de controlar o comportamento do complemento ou enviar informações para 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 oferece suporte para mostrar as 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 ambos os casos, é necessário fornecer o nome de uma função de gatilho da página inicial no projeto de script do seu complemento. Essa função é chamada automaticamente para criar a página inicial do Gmail quando necessário. É necessário implementar essa função para criar e retornar um único objeto 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 criação da página inicial.

O que você pode criar

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

Ao configurar o 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: