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 independente fornece instruções para criar novos projetos.
Também é possível
abrir um novo script.
Se fizer isso, o arquivo do projeto (inicialmente 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 editar o projeto de script do complemento, mas não precisa ser 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 o uso de 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 é 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 na nuvem do complemento.
Programar o complemento
Depois de criar um projeto de script, você pode começar 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 dos complementos (caixas de diálogo e barras laterais) usando HTML e CSS convencionais. Os complementos do Editor também podem definir itens de menu personalizados.
Conforme você digita, consulte o Guia de estilo dos complementos do Editor para ver orientações sobre como criar a experiência do usuário de complementos. Além disso, entenda e programe para os diferentes estados do ciclo de vida de autorização que seu complemento pode encontrar.
Testar o complemento
É possível 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 ver mais detalhes.
Publicar o complemento
Ao publicar o complemento, ele fica disponível para outras pessoas, publicamente ou apenas para os usuários do 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 passar pela revisão antes de serem publicados.
Consulte Publicar um complemento do Editor para mais detalhes.