Quando você publica um complemento, os usuários podem instalá-lo pelo aplicativo host ou pelo Google Workspace Marketplace. Antes de publicar, teste os complementos que você desenvolve nos aplicativos host que eles estendem.
Esta página descreve como instalar um complemento que está em desenvolvimento (chamado de não publicado ou do desenvolvedor (link em inglês) para uso pessoal ou de teste. Também é possível depurar complementos usando o depuração e os pontos de interrupção do ambiente de desenvolvimento integrado do Apps Script.
Pré-requisitos
- É necessário ter acesso de editor ao projeto do script do complemento.
- Para permitir que outras pessoas na sua organização testem o complemento, conceda a elas acesso de editor ao projeto do script. Para saber mais 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 Deployments do Apps Script.
Siga estas etapas para instalar um complemento não publicado do Google Workspace para testes:
- Abra o projeto do script no editor do Apps Script.
- Clique em Implantar > Testar implantações.
- Clique em Instalar.
- Na parte de baixo, clique em Concluído.
Para permitir que outros usuários testem o complemento, compartilhe o projeto do Apps Script com a conta deles (é necessário ter acesso de edição). Em seguida, peça para os usuários seguirem 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 antes que o complemento apareça. 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:
- Abra o projeto do script no editor do Apps Script.
- Clique em Implantar > Testar implantações.
- Clique em Desinstalar.
- Na parte de baixo, clique em Concluído.
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 do Google Workspace, siga as práticas recomendadas para desenvolvimento de complementos. Além disso, faça o seguinte:
A navegação do card de teste flui completamente em todos os aplicativos host que o complemento estende. Verifique se o comportamento do complemento está correto conforme o usuário muda de contexto e entre cards não contextuais e contextuais.
Use dados de teste de exemplo para avaliar o comportamento do seu complemento.
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 ele se comporta como esperado. Confira se o complemento está processando os detalhes de autorização e login corretamente.
Verifique se todas as condições de erro são tratadas corretamente. Use cards de erro quando necessário.
Preste atenção no desempenho do complemento. Se você fizer uma mudança no código e o complemento começar a ficar lento, talvez seja necessário remover ou refazer esse recurso.