Siga este procedimento geral ao criar um complemento do editor:
- Crie um projeto do Apps Script.
- Escreva o código para definir a aparência e o comportamento do complemento usando o serviço HTML integrado do Apps Script.
- Teste o complemento.
- Publique o complemento.
Criar um projeto de script
Um complemento do Editor é um projeto independente do Apps Script. O guia de script autônomo fornece instruções para criar novos projetos.
Também é possível simplesmente abrir um novo script.
Se você fizer isso, o arquivo do projeto (inicialmente chamado de Untitled project
) será
colocado na pasta raiz do Drive.
Colaboração
Quando você colabora com outras pessoas no desenvolvimento de um complemento, o projeto do complemento tem apenas uma conta de usuário. Quando você publica um complemento, uma única conta de usuário atua como editor. A conta de publicação precisa ter acesso para editar ao projeto de script do complemento, mas não precisa ser a proprietária do projeto.
É muito importante evitar situações em que você perca o acesso ao código ou às configurações de um complemento porque o proprietário do projeto saiu da organização.
Para não perder o acesso ao código do complemento, recomendamos que você use drives compartilhados ao colaborar em um complemento. Colocar o arquivo de script do complemento em um drive compartilhado garante que nenhuma conta seja a única proprietária do projeto.
Também é recomendado que você adicione colaboradores ao projeto do Cloud Platform (GCP) do projeto de script. Isso ajuda a garantir que alguém da sua equipe sempre tenha acesso às configurações do complemento na nuvem.
Codificar o complemento
Depois de criar um projeto de script, comece a escrever o código para definir a aparência e o comportamento do complemento. Use o HtmlService do Apps Script para criar a interface do usuário do complemento (caixas de diálogo e barras laterais) com HTML e CSS convencional. Os complementos do Editor também podem definir itens de menu personalizados.
Durante a programação, consulte o guia de estilo do complemento do Editor para conferir diretrizes sobre como criar a experiência do usuário do seu complemento. Além disso, entenda e programe 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 da publicação para garantir que eles funcionem conforme o esperado. Os testes exigem que você crie uma configuração de teste e use um documento, uma planilha, um formulário ou uma apresentação de teste.
Consulte Testar um complemento do editor para mais detalhes.
Publicar o complemento
A publicação do seu complemento o disponibiliza para outras pessoas, publicamente ou apenas para usuários no seu 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 revisão antes de serem publicados.
Consulte Como publicar um complemento do editor para mais detalhes.