Tipos de complementos

Esta página oferece uma visão geral dos dois tipos de complementos que você pode criar: complementos do Google Workspace e complementos do editor. Esses tipos de complementos diferem nos aplicativos que estendem, nos métodos de criação e nas restrições.

Complementos do Google Workspace

Os complementos do Google Workspace são a geração mais recente de complementos e oferecem muitos recursos, incluindo os seguintes:

  • Crie um complemento para vários apps do Google Workspace: em vez de complementos separados para cada app, você pode criar e gerenciar um único complemento do Google Workspace que funciona em todo o Google Workspace. Um complemento do Google Workspace pode estender os seguintes aplicativos host:

    • Gmail
    • Google Agenda
    • Google Chat
    • Google Docs
    • Google Drive
    • Google Meet
    • Google Planilhas
    • Google Slides

  • Aumente o reconhecimento da marca: os ícones de complementos ficam visíveis por padrão no painel à direita dos apps host.

  • Crie experiências de página inicial: crie páginas iniciais individuais para cada app do Google Workspace que seu complemento estende ou use a mesma página inicial para vários apps.

  • Reflita o contexto no seu complemento: crie seu complemento do Google Workspace para mostrar interfaces específicas do app host. Por exemplo, seu complemento pode mostrar informações de um e-mail ou evento da Agenda ou sugerir uma ação com base na página atual do app do Google Workspace.

  • Use interfaces padronizadas: crie interfaces do usuário com elementos de widget integrados fornecidos pelo serviço do Google Apps ScriptCard. Não é necessário ter experiência com HTML ou CSS para definir essas interfaces.

  • Estenda os clientes de computador e dispositivos móveis do Gmail: se um complemento do Google Workspace estender o Gmail, use-o nas versões para computador e dispositivos móveis. Não é necessário criar uma versão separada para dispositivos móveis. A mesma interface é usada em todos os lugares.

  • Use o ambiente de execução preferido: desenvolva complementos do Google Workspace com a infraestrutura de hospedagem, as ferramentas de desenvolvimento, o sistema de controle de origem, linguagem de programação e as bibliotecas de código de sua preferência.

Complementos de editor

Os complementos de editor estendem um aplicativo do Google Editor, como Documentos, Planilhas, Apresentações ou Formulários. Cada tipo de complemento de editor (por exemplo, complementos do Planilhas) tem recursos, restrições e considerações especiais específicos do tipo. Ao criar complementos de editor, entenda esses detalhes específicos do editor. Para mais detalhes sobre complementos para editores específicos, consulte o seguinte:

Os complementos de editor podem automatizar tarefas comuns do editor, como criação, edição, formatação e movimentação de dados entre aplicativos. As interfaces de complementos de editor são altamente personalizáveis.

Os complementos de editor são ideais para automatizar tarefas no Documentos, Planilhas, Apresentações ou Formulários Google para uso individual ou interno. Para complementos que exigem recursos em grande escala que precisam processar muitos usuários, exigem baixa latência ou exigem controle total sobre sua infraestrutura, considere criar um complemento do Google Workspace em um ambiente de execução diferente para ter mais controle sobre a infraestrutura, a implantação e os processos de lançamento.

Os complementos de editor se comportam de maneira diferente dos complementos do Google Workspace destas maneiras:

  • Os complementos de editor podem criar interfaces que consistem em itens de menu, caixas de diálogo e barras laterais. As interfaces são definidas usando HTML e CSS padrão.
  • Os complementos de editor têm regras de autorização especiais porque interagem com arquivos no Google Drive. Entenda a autorização de complementos de editor ao desenvolver um complemento de editor.
  • Os arquivos criados e atualizados em cada editor têm estruturas específicas. Por exemplo, as apresentações do Google Slides são compostas de páginas como slides, modelos ou layouts. Entenda essas estruturas de arquivos, já que os complementos costumam interagir com elas ao ler ou editar arquivos.
  • Os complementos de editor só funcionam em clientes de computador, não em Android ou iOS.
  • Os complementos de editor precisam ser implementados no Apps Script.