Como criar complementos do Editor

Siga este procedimento geral ao criar um complemento do Editor:

  1. Crie um projeto do Apps Script.
  2. Escreva o código para definir a aparência e o comportamento do complemento usando o serviço HTML integrado do Apps Script.
  3. Teste o complemento.
  4. 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.