Tipos de complementos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, apresentamos uma visão geral dos dois tipos de complementos que podem ser criados: Complementos do Google Workspace e Complementos do editor. Esses tipos de complemento diferem em quais aplicativos eles estendem, como são criados e quais restrições eles têm.

Complementos do Google Workspace

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

  • Crie apenas um complemento para vários apps do Google Workspace: em vez de complementos separados para o Gmail, o Agenda, o Drive e os Editores, você pode criar e gerenciar um único complemento do Google Workspace para estender vários apps do Google Workspace.

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

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

  • Mostre o contexto do usuário no seu complemento: você pode criar seu complemento do Google Workspace para mostrar interfaces específicas do app host do complemento. Por exemplo, ele pode exibir informações de um e-mail ou evento da agenda no complemento ou sugerir uma ação com base na página atual do app Google Workspace.

  • Usar interfaces padronizadas: crie interfaces do usuário com base nos 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.

  • Ampliar 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 do Gmail para computador e para dispositivos móveis. Se você criar um complemento do Google Workspace que estenda o Gmail, não precisará criar uma versão para dispositivos móveis separada. A mesma interface é usada em todos os lugares.

  • Use o ambiente de execução de sua preferência. Como alternativa ao Apps Script, você pode 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 preferidas. Para saber mais, consulte Criar um complemento em qualquer linguagem de programação.

Complementos de editor

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

Os complementos do editor podem automatizar tarefas comuns de criação, como criação, edição, formatação e transferência de dados entre aplicativos. As interfaces de complemento 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 compostas por itens de menu, caixas de diálogo e barras laterais. As caixas de diálogo e as barras laterais dos complementos são definidas usando HTML e CSS padrão.
  • Os complementos do editor têm regras de autorização especiais porque eles criam, modificam ou interagem com arquivos no Google Drive. É importante entender o ciclo de vida da autorização dos complementos do editor durante o desenvolvimento de um complemento.
  • 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, mestres ou layouts. É necessário entender essas estruturas de arquivo, já que os complementos geralmente interagem com eles 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 criados no Apps Script.