Testar os complementos do Google Workspace

Quando você publica um complemento, os usuários podem instalá-lo no aplicativo host ou no Google Workspace Marketplace. No entanto, antes da publicação, é útil testar os complementos que você desenvolve nos aplicativos hospedados que eles estendem.

Nesta página, descrevemos como instalar um complemento em desenvolvimento (chamado de não publicado ou de desenvolvedor) para testes ou uso pessoal.

Requisitos

Para instalar um complemento Google Workspacenão publicado para teste, é necessário ter acesso para editar ao projeto do script desse complemento. Isso significa que os colaboradores da organização poderão testar complementos se você conceder acesso para editar ao projeto de script.

Instalar um complemento não publicado

É possível instalar complementos não publicados da caixa de diálogo Implantações do Apps Script.

Siga estas etapas para instalar um complemento não publicado Google Workspace Complemento para testes:

Novo editor

  1. Abra o projeto de script no editor do Apps Script.
  2. Clique em Implantar > Implantar implantações.
  3. Clique em Install.
  4. Na parte inferior, clique em Concluído.

Editor legado

  1. Abra o projeto de script dos complementos no editor do Apps Script.
  2. Selecione Publish > Deploy from manifest... para abrir a caixa de diálogo Deployments.
  3. Na linha Versão mais recente (principal), clique em Instalar complemento para instalar a versão salva do complemento no modo de desenvolvimento. Se você instalar a versão mais recente (principal) do complemento, qualquer alteração feita nele será aplicada imediatamente sem precisar reinstalá-lo.
  4. Se preferir, crie uma implantação com controle de versão e instale-a. Isso pode ser útil se você quiser 'checkpoint' uma versão do complemento para compará-lo com a versão em desenvolvimento.

Você pode permitir que outros usuários testem o complemento compartilhando o projeto do Apps Script com a conta deles. Você precisa ter acesso para editar. Em seguida, solicite que os usuários sigam as etapas acima.

Depois de instalado, o complemento é disponibilizado imediatamente nos aplicativos host que ele estende. Talvez seja necessário atualizar a guia do aplicativo host antes da exibição do complemento. Você também precisa autorizar o complemento antes de usá-lo.

Desinstalar um complemento não publicado

Para desinstalar uma implantação de complemento não publicada, siga estas etapas:

Novo editor

  1. Abra o projeto de script no editor do Apps Script.
  2. Clique em Implantar > Implantar implantações.
  3. Clique em Desinstalar.
  4. Na parte inferior, clique em Concluído.

Editor legado

  1. Abra o projeto do script de complementos no editor do Apps Script.
  2. Selecione Publish > Deploy from manifest... para abrir a caixa de diálogo Deployments.
  3. Clique no link Desinstalar complemento da implantação instalada.

Essas etapas removem imediatamente a implantação, e o complemento não aparece mais em nenhum aplicativo host. É possível reinstalar a implantação a qualquer momento repetindo o procedimento de instalação.

Práticas recomendadas para testes

Ao testar o complemento Google Workspace , siga as Práticas recomendadas para o desenvolvimento de complementos. Além disso, faça o seguinte:

  1. A navegação do cartão de teste flui completamente em todos os aplicativos host que o complemento se estende. Verifique se o comportamento dos complementos está correto à medida que o usuário alterna de contexto para contexto e entre cards não contextuais e contextuais.

  2. Use exemplos de dados de teste para avaliar o comportamento dos complementos.

  3. Se o complemento se conectar a uma API de terceiros ou a outro serviço, verifique se o serviço pode ser acessado e se comporta conforme o esperado. Verifique se seu complemento está processando os detalhes de autorização e login corretamente.

  4. Todas as condições de erro precisam ser processadas corretamente. Use cards de erro quando necessário.

  5. Preste atenção ao desempenho do complemento. Se você fizer uma mudança no código e o complemento começar a desacelerar, talvez seja necessário remover ou reformular esse recurso.