Interfaces baseadas em cartão

Observação: os complementos do Google Workspace são baseados em cards.Os complementos do editor são baseados em HTML.

Os complementos do Google Workspace apresentam informações e controles do usuário na barra lateral da interface do aplicativo host. Um complemento consiste em uma barra de ferramentas de identificação principal e um ou mais cards.

Cada card representa uma "página" específica da interface do complemento, e navegar até um novo card geralmente é apenas uma questão de criar esse card e enviá-lo para uma pilha de cards interna. Você pode definir fluxos de navegação entre cards para uma experiência de interação avançada.

Os cards podem ser não contextuais ou contextuais. Os 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. Os 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 Google Agenda.

Os complementos do Google Workspace criados no Apps Script usam o serviço de card para criar interfaces de usuário com cards. Os complementos criados em outras linguagens precisam retornar JSON formatado corretamente para que a interface seja renderizada como cards.

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 oferecem controles de interação, como botões.

As interfaces baseadas em cards 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 cards funcionam em computadores e dispositivos móveis, mas você só precisa definir a interface uma vez.

  Observação: no momento, o Gmail é o único aplicativo host que pode ser estendido por complementos do Google Workspace em dispositivos móveis.

Como criar interfaces baseadas em cards

Ao criar complementos baseados em cards, é importante entender alguns conceitos e padrões de design. Os guias a seguir fornecem as informações necessárias para criar complementos eficazes baseados em cards:

• Cards
• Páginas iniciais
• Widgets
• Actions
• Objetos de evento
• Como criar cards
• Como criar cards interativos
• Navegar entre cards
• Usar ações universais
• Adicionar o recurso de preenchimento automático às entradas de texto
• 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 estas páginas ao criar cards e implementar comportamento da interface. As amostras adicionais a seguir também podem ser úteis para referência ao implementar seu complemento:

• Guia de início rápido do complemento "Gatos" do Google Workspace

  Este exemplo de complemento mostra uma interface simples do Google Workspace com várias páginas e páginas iniciais.

• Complemento do Google Workspace: "Traduzir"

  Este exemplo mostra um complemento do Google Workspace que permite aos usuários traduzir texto nos Documentos, Planilhas e Apresentações Google.

• Complemento do Google Workspace: "Lista de equipes"

  Este exemplo de complemento mostra um exemplo mais complexo 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 de eventos da Agenda. Só é possível usar esse complemento em um domínio, já que ele usa a API Directory para recuperar informações do usuário.