Antes de criar seu complemento do editor, consulte as cotas e limitações do Apps Script para garantir que o design do projeto esteja alinhado a essas diretrizes. Conhecer esses limites no início do processo de desenvolvimento pode ajudar a evitar possíveis problemas mais tarde. O Apps Script é ideal para o desenvolvimento de complementos leves para você, sua equipe ou sua organização. No entanto, se você pretende criar um complemento em grande escala que precise lidar com muitos usuários, exija baixa latência ou controle total sobre sua infraestrutura, considere desenvolver um complemento do Google Workspace em um ambiente de tempo de execução diferente.
Siga este procedimento geral ao criar um complemento do Editor:
- Crie um projeto do Apps Script.
- Escreva 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 scripts independentes fornece instruções para criar novos projetos.
Você também pode apenas
abrir um novo script.
Se você fizer isso, o arquivo do projeto (inicialmente chamado Untitled project) será
colocado na pasta raiz do Drive.
Colaboração
Ao colaborar com outras pessoas no desenvolvimento de um complemento, uma única conta de usuário é proprietária do projeto de complemento. Ao publicar um complemento, uma única conta de usuário atua como editor. A conta de publicação precisa ter acesso de edição ao projeto de script do complemento, mas não precisa ser proprietária dele.
É 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 saiu da sua organização.
Para não perder o acesso ao código do complemento, recomendamos usar 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 recomendamos que você adicione colaboradores ao projeto do Cloud Platform (GCP) do projeto de script. Isso ajuda a garantir que alguém na sua equipe sempre possa acessar as configurações de nuvem do complemento.
Codificar 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 ver diretrizes sobre como criar a experiência do usuário do 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
É possível testar os complementos do Editor antes da publicação para garantir que eles funcionem como esperado. Para testar, 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
Ao publicar seu complemento, ele fica disponível para outras pessoas, seja publicamente ou apenas para usuários no seu domínio. Antes de iniciar o processo de publicação, revise 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 por uma análise antes de serem publicados.
Consulte Publicar um complemento do editor para mais detalhes.