Complementos de criação de editores

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

Siga este procedimento geral ao criar um complemento do editor:

  1. Crie um projeto do Apps Script.
  2. Escreva o código para definir a aparência e o comportamento do complemento usando o serviço HTML integrado do Apps Script.
  3. Teste o complemento.
  4. Publique o complemento.

Criar um projeto de script

Um complemento do editor é um projeto do Apps Script independente. O guia de script autônomo fornece instruções para criar novos projetos. Você também pode abrir um script novo. Se você fizer isso, o arquivo do projeto (chamado inicialmente de Untitled project) será colocado na pasta raiz do Drive.

Colaboração

Quando você colabora com outras pessoas no desenvolvimento de um complemento, uma única conta de usuário é proprietária do projeto do complemento. Quando você publica um complemento, uma única conta de usuário atua como o editor. A conta de publicação precisa ter acesso para edição ao projeto de script do complemento, mas não precisa ser proprietária do projeto.

É muito importante evitar situações em que você perde o acesso ao código ou às configurações de um complemento porque o proprietário do projeto saiu da organização.

Para evitar a perda do acesso ao código complementar, recomendamos o uso de drives compartilhados ao colaborar em um complemento. Colocar o arquivo do script de complementos em um drive compartilhado garante que nenhuma conta seja a única proprietária do projeto.

Também é recomendável adicionar colaboradores ao projeto do Cloud Platform (GCP) do projeto de script. Isso garante que alguém da sua equipe sempre possa acessar as configurações do Cloud dos complementos.

Programe o complemento

Depois de criar um projeto de script, você pode começar a escrever código para definir a aparência e o comportamento dos complementos. Use o HTMLService do Apps Script para criar a interface do usuário de complementos (caixas de diálogo e barras laterais) usando HTML e CSS convencional. Os complementos do editor também podem definir itens de menu personalizados.

Ao programar, consulte o guia de estilo de complementos do editor para ver diretrizes sobre como projetar a experiência do usuário dos complementos. Além disso, verifique se você entende e programa os diferentes estados do ciclo de vida de autorização que seu complemento pode encontrar.

Testar o complemento

Você pode testar os complementos do editor antes de publicá-los para garantir que eles tenham o comportamento esperado. Para testar, você precisa criar uma configuração de teste e usar um documento, uma planilha, um formulário ou uma apresentação de teste.

Veja mais detalhes em Testar um complemento do editor.

Publicar o complemento

A publicação do complemento o torna disponível para outras pessoas, publicamente ou apenas para usuários no domínio. Antes de iniciar o processo de publicação, consulte a visão geral da publicação.

Os complementos do editor são publicados no Google Workspace Marketplace. Os complementos disponíveis publicamente precisam concluir a avaliação dos complementos antes da publicação.

Consulte Como publicar um complemento do editor para saber mais.