Os complementos do Google Workspace apresentam informações e controles do usuário na barra lateral da IU do aplicativo host. Um complemento consiste em uma barra de ferramentas de identificação principal com um ou mais cards.
Cada card representa uma "página" específica da IU do seu complemento, e navegar até um novo cartão geralmente é apenas uma questão de criar esse cartão e colocá-lo em uma pilha interna de cartões. Você pode definir os fluxos de navegação entre cards para uma experiência de interação mais rica.
Os cards podem ser não contextuais ou contextuais. Cards contextuais são apresentados ao usuário quando o aplicativo host está em um contexto específico. Por exemplo, ao abrir uma mensagem do Gmail ou um evento do Google Agenda. Cards não contextuais, como páginas iniciais, são apresentados ao usuário fora de um contexto específico do host. Por exemplo, quando o usuário está acessando a caixa de entrada do Gmail, a pasta principal do Drive ou o Agenda.
Os complementos do Google Workspace criados no Apps Script usam o serviço de cards para criar interfaces do usuário usando cards. Os complementos criados em outras linguagens precisam retornar o JSON formatado corretamente para que a interface seja renderizada como cartões.
Cada card consiste em um cabeçalho e uma ou mais seções. Cada seção é composta por um conjunto de widgets. Os widgets mostram informações ao usuário ou fornecem controles de interação, como botões.
As interfaces baseadas em cartão têm os seguintes benefícios:
- Não é necessário ter conhecimento de HTML ou CSS para criar interfaces baseadas em cards.
- Os cards e widgets são estilizados automaticamente para funcionar bem com os aplicativos do Google Workspace que eles estendem.
As interfaces baseadas em cartão funcionam em computadores e dispositivos móveis, mas você só precisa defini-las uma vez.
Como criar interfaces baseadas em cartão
Ao criar complementos baseados em cards, é importante entender alguns conceitos e padrões de design. Os guias abaixo fornecem as informações necessárias para criar complementos baseados em cards eficazes:
- Cards
- Páginas iniciais
- Widgets
- Actions
- Objetos de evento
- Cards de construção
- Como criar cards interativos
- Navegar entre cards
- Como usar ações universais
- Adicionar o preenchimento automático às entradas de texto
- Como acessar as localidades e fusos horários dos usuários
- Como se conectar a serviços de terceiros
- Guia de estilo
- Práticas recomendadas
Consulte essas páginas ao criar cards e implementar o comportamento da IU. Os outros exemplos abaixo também podem ser úteis para referência ao implementar seu complemento:
Guia de início rápido do complemento do Google Workspace "Cats"
Este exemplo de complemento mostra uma IU simples de complemento do Google Workspace com várias páginas e páginas iniciais.
Complemento do Google Workspace: "Traduzir"
Este exemplo de complemento mostra um complemento do Google Workspace que permite aos usuários traduzir textos dentro do Documentos, Planilhas e Apresentações.
Complemento do Google Workspace: "Lista de equipes"
Este exemplo de complemento mostra um exemplo mais complexo do Google Workspace, que mostra informações do usuário sobre destinatários de mensagens do Gmail, editores de arquivos do Drive ou participantes de eventos do Google Agenda. Você só pode usar esse complemento dentro de um domínio, porque ele usa a API Directory para recuperar informações do usuário.