Testar complementos do Google Workspace

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

Esta página descreve como instalar um complemento que está em desenvolvimento (chamado de complemento não publicado ou de desenvolvedor) para teste ou uso pessoal.

Pré-requisitos

  • Você precisa ter acesso de editor ao projeto de script do complemento.
  • Para permitir que outras pessoas na sua organização testem o complemento, conceda a elas acesso de editor ao projeto de script. Para detalhes sobre como conceder acesso, consulte Como colaborar com outros desenvolvedores.

Instalar um complemento não publicado

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

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

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

É possível permitir que outros usuários testem o complemento compartilhando o projeto do Apps Script com a conta deles (é necessário ter acesso para edição). Em seguida, peça que os usuários sigam as etapas acima.

Depois de instalado, o complemento fica imediatamente disponível nos aplicativos host que ele estende. Talvez seja necessário atualizar a guia do aplicativo host para que o complemento apareça. Também é necessário 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:

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

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

Práticas recomendadas de teste

Ao testar o complemento do Google Workspace, siga as práticas recomendadas para 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 estende. Verifique se o comportamento do complemento está correto à medida que o usuário passa de contexto para contexto e entre cards não contextuais e contextuais.

  2. Use exemplos de dados de teste para avaliar o comportamento do complemento.

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

  4. Verifique se todas as condições de erro foram tratadas corretamente. Use cartões de erro quando necessário.

  5. Preste atenção no desempenho do complemento. Se você fizer uma alteração no código e o complemento começar a ficar mais lento, talvez seja necessário remover ou retrabalhar esse recurso.