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 em quais aplicativos eles estendem, como são criados e quais restrições têm.

Complementos do Google Workspace

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

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

    • Gmail
    • Google Agenda
    • Google Chat (prévia para desenvolvedores)
    • Documentos Google
    • Google Drive
    • Planilhas Google
    • Apresentações Google

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

  • Criar experiências na página inicial: você pode criar páginas iniciais individuais para cada app do Google Workspace que seu complemento estende ou usar a mesma página inicial para vários apps.

  • Reflita o contexto do usuário no seu complemento: você pode projetar seu complemento do Google Workspace para mostrar interfaces específicas do app host. Por exemplo, ele 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 Card do Apps Script. Não é necessário ter experiência com HTML ou CSS para definir essas interfaces.

  • Estender clientes de computador e dispositivos móveis para o Gmail: se um complemento do Google Workspace estender o Gmail, você poderá usá-lo nas versões para computador e dispositivos móveis do Gmail. Se você criar um complemento do Google Workspace que estenda o Gmail, não será necessário projetar uma versão separada para dispositivos móveis. A mesma interface é usada em todos os lugares.

  • Use o ambiente de execução de sua preferência. É possível desenvolver complementos do Google Workspace com sua infraestrutura de hospedagem, cadeia de ferramentas de desenvolvimento, sistema de controle de origem, linguagem de programação e bibliotecas de código preferidos.

Complementos do editor

Os complementos do editor estendem um dos aplicativos do Editor do Google, como Documentos, Planilhas, Apresentações ou Formulários. Cada tipo de complemento do Editor (por exemplo, complementos do Planilhas) pode ter um conjunto próprio de recursos, restrições e considerações especiais específicos do tipo. Ao criar complementos do Editor, é importante entender esses detalhes específicos do Editor. Para mais detalhes sobre complementos de editores específicos, consulte as seções correspondentes:

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

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

Os complementos do editor se comportam de maneira diferente dos complementos do Google Workspace das seguintes formas:

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