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 Apps Script independente
projeto. O guia de script autônomo fornece
instruções para criar novos projetos.
Você também pode
abra um novo script.
Se você fizer isso, o arquivo de projeto (inicialmente chamado de Untitled project
) será
em sua pasta raiz do Drive.
Colaboração
Quando você colabora com outras pessoas no desenvolvimento de um complemento, uma única conta de usuário é proprietário do projeto de complemento. Quando você publica um complemento, uma única conta de usuário atua como editor. A conta de publicação precisa ter acesso para editar o complemento projeto de script, mas não precisa ser proprietário do projeto.
É muito importante evitar situações em que você perca o acesso ao complemento porque o proprietário do projeto saiu da organização.
Para evitar perder o acesso ao código do complemento, recomendamos o uso drives compartilhados quando você colabora em um complemento. Colocar o arquivo de script do complemento em um arquivo Google Drive garante que nenhuma conta seja a única proprietária do projeto.
Também recomendamos 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 ao complemento do Google Cloud.
Codificar o complemento
Depois de criar um projeto de script, você pode começar a escrever para definir a aparência e o comportamento do complemento. Usar o Apps Script HtmlService para construir o usuário do complemento interface, caixas de diálogo e barras laterais, usando HTML e CSS convencionais. Os complementos do editor podem definir itens de menu.
Ao programar, consulte o Guia de estilo do complemento do editor para orientações sobre como criar a experiência do usuário do seu complemento. Além disso, verifique se que você entende e programa para os diferentes estados do ciclo de vida de 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 funcionem bem. como esperado. Os testes exigem que você crie uma configuração de teste e use um documento, planilha, formulário ou 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 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. Complementos disponíveis publicamente precisa concluir a revisão do complemento antes de serem publicados.
Consulte Como publicar um complemento do editor. para mais detalhes.