Os complementos do Google Workspace apresentam informações e usuários controles na barra lateral do aplicativo host de ML pela UI. Um complemento consiste em uma barra de ferramentas principal de identificação, juntamente com uma ou mais cards.
Cada card representa uma "página" específica. da interface do seu complemento. como acessar um novo cartão geralmente é apenas uma questão de criar esse cartão e enviando o cartão para uma pilha interna de cards. Você pode definir os fluxos de navegação entre os cards para ter uma experiência de interação avançada.
Os cards podem ser não contextuais ou contextuais. Cards contextuais são apresentados para o usuário quando o aplicativo host está em um contexto específico. Por exemplo: ao abrir uma mensagem do Gmail ou um evento da Agenda. Cards não contextuais (como homepages) são apresentadas ao usuário. fora de um contexto específico do host. Por exemplo, quando o usuário visualizar a caixa de entrada do Gmail, a pasta principal do Drive ou o Agenda.
Os complementos do Google Workspace integrados ao Apps Script usam a Serviço de cartão para criar interfaces do usuário fora de cards. Complementos criados em outros idiomas precisa retornar um 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 é composto por um conjunto de widgets. Widgets exibir informações ao usuário ou fornecer controles de interação, como botões.
As interfaces baseadas em cartões têm os seguintes benefícios:
- Não é necessário ter conhecimento de HTML ou CSS para criar interfaces baseadas em cards.
- Cards e widgets são estilizados automaticamente para funcionar bem com o os aplicativos do Google Workspace que elas estendem.
As interfaces baseadas em cartões funcionam em computadores e dispositivos móveis, mas você só precisa definir a interface uma vez.
Como criar interfaces baseadas em cartões
Ao criar complementos baseados em cards, é importante entender certos conceitos e padrões de design. Os guias a seguir fornecem as informações você precisa criar complementos eficazes com base em cartões:
- 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
- Como adicionar o preenchimento automático a entradas de texto
- Como acessar localidades e fusos horários dos usuários
- Como se conectar a serviços que não são do Google
- Guia de estilo
- Práticas recomendadas
Consulte essas páginas ao criar cards e implementar Comportamento da interface. Os exemplos a seguir também podem ser úteis para referência ao implementar seu complemento:
Complemento do Google Workspace "Cats" guia de início rápido
Este exemplo de complemento mostra uma interface simples de complemento do Google Workspace com várias páginas e páginas iniciais.
Complemento do Google Workspace: "Tradutor"
Este exemplo mostra um complemento do Google Workspace que permite aos usuários traduzir textos em Documentos, Planilhas e Apresentações.
Complemento do Google Workspace: "Lista de equipes"
Este exemplo de complemento mostra um exemplo exemplo de complemento do Google Workspace, que mostra informações do usuário sobre destinatários de mensagens do Gmail, editores de arquivos do Drive ou Participantes do evento na agenda. Esse complemento só pode ser usado dentro de um domínio, já que ele usa a API Directory para recuperar informações do usuário.