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 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 para desenvolver um complemento, uma única conta de usuário é proprietária do projeto. 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 de complementos, mas não precisa ser de proprietário 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 evitar a perda de acesso ao código do complemento, recomendamos que você use drives compartilhados ao colaborar em um complemento. Colocar o arquivo de 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 ajuda a garantir que alguém da sua equipe sempre possa acessar as configurações de nuvem do complemento.
Codificar o complemento
Depois de criar um projeto de script, você poderá começar a escrever código para definir a aparência e o comportamento do complemento. Use o Apps Script HTMLService para criar a interface do usuário complementar caixas de diálogo e barras laterais usando HTML e CSS convencionais. Os complementos do editor também podem definir itens de menu personalizados.
Ao programar, consulte o Guia de estilo do complemento do Editor para conferir diretrizes sobre como projetar a experiência do complemento. Além disso, é preciso entender e programar os diferentes estados do ciclo de vida da autorização que o complemento pode encontrar.
Testar o complemento
Você pode testar os complementos do editor antes da publicação para garantir que eles tenham o comportamento esperado. Para testar, é necessário 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 disponibiliza para outras pessoas, publicamente ou apenas 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 avaliação dos complementos antes da publicação.
Consulte Como publicar um complemento do Editor para ver mais detalhes.