Siga este procedimento geral ao criar um complemento do Editor:
- Crie um projeto do Apps Script.
- Escreva um 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 oferece
instruções para criar novos projetos.
Você também pode
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, uma conta de usuário único é proprietária do projeto. Quando você publica um complemento, uma conta de usuário único atua como o editor. A conta de publicação precisa ter acesso de edição ao projeto de script do complemento, mas não precisa ser a 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 deixou sua organização.
Para evitar a perda de acesso ao código do complemento, recomendamos o uso de unidades compartilhadas 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 que você adicione colaboradores ao projeto do Cloud Platform (GCP) do script. Isso ajuda a garantir que alguém da sua equipe sempre possa acessar as configurações de nuvem do complemento.
Programar 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 do complemento. Você usa o HtmlService do Apps Script para criar a interface do usuário do complemento, 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 usuário do complemento. Além disso, entenda e programe para os diferentes estados do ciclo de vida de autorização que o complemento pode encontrar.
Testar o complemento
É possível testar os complementos do Editor antes da publicação para garantir que eles se comportem como esperado. Para fazer testes, você precisa criar uma configuração de teste e usar 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 torna disponível para outras pessoas, seja publicamente ou apenas para usuários no seu domínio. Antes de iniciar o processo de publicação, leia 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 análise de complemento antes de serem publicados.
Consulte Publicar um complemento do Editor para mais detalhes.