Tipos de complementos

Nesta página, você encontra uma visão geral dos dois tipos de complementos que podem ser criados: Complementos do Google Workspace e Complementos do Editor. Esses tipos de complementos diferem entre os aplicativos que eles estendem, como eles são criados e as restrições que têm.

Complementos do Google Workspace

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

  • Criar apenas um complemento para vários apps do Google Workspace: em vez de complementos separados para o Gmail, o Google Agenda, o Drive e os Editores, é possível criar e gerenciar um único complemento do Google Workspace para estender vários apps do Google Workspace.

  • Aumentar o reconhecimento da marca: por padrão, os ícones de complementos ficam visíveis no painel do lado direito dos apps host dos complementos.

  • Criar experiências de página inicial: é possível 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 criar seu complemento do Google Workspace para mostrar interfaces específicas para o app host do complemento. Por exemplo, seu complemento pode exibir informações de um e-mail ou evento da agenda ou sugerir uma ação com base na página atual do app Google Workspace.

  • Usar 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 computadores 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 amplie o Gmail, não será necessário projetar uma versão separada do complemento para dispositivos móveis. A mesma interface é usada em todos os lugares.

  • Use o ambiente de execução que preferir. Como alternativa ao Apps Script, desenvolva complementos do Google Workspace com a infraestrutura de hospedagem, a cadeia de ferramentas de desenvolvimento, o sistema de controle de origem, a linguagem de programação e as bibliotecas de código que preferir. Para saber mais, consulte Criar um complemento em qualquer linguagem de programação.

Complementos do editor

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

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

Os complementos do Editor se comportam de maneira diferente dos complementos do Google Workspace das seguintes maneiras:

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