Depois de publicar um complemento, os usuários podem instalá-lo pelo aplicativo host ou pelo Google Workspace Marketplace. Antes de publicar, teste o complemento nos aplicativos host que ele estende.
Nesta página, descrevemos como instalar um complemento que está em desenvolvimento (um complemento não publicado ou para desenvolvedores ) para teste ou uso pessoal. Você também pode depurar o complemento usando o depurador e pontos de interrupção do Apps Script.
Pré-requisitos
- É necessário ter acesso de editor ao projeto de script.
- Para permitir que outras pessoas testem o complemento, conceda a elas acesso de edição ao projeto. Consulte Colaborar com outros desenvolvedores.
- Os usuários de teste precisam pertencer ao mesmo domínio que o proprietário do script.
Instalar um complemento não publicado
Instale complementos não publicados na caixa de diálogo Implantações.
Para instalar um complemento não publicado para teste, siga estas etapas:
- Abra o projeto de script no editor do Apps Script.
- Selecione Implantar > Testar implantações.
- Selecione Instalar.
- Na parte de baixo, selecione Concluído.
Para permitir que outros usuários testem o complemento, compartilhe o projeto com a conta deles (é necessário acesso de edição). Em seguida, peça para os usuários seguirem as mesmas etapas.
Depois de instalar o complemento, ele fica disponível imediatamente nos aplicativos host que ele estende. Talvez seja necessário atualizar a guia do aplicativo host antes que o complemento apareça. Autorize o complemento antes de usá-lo. Se o projeto já estiver autorizado, use ScriptApp.invalidateAuth para invalidar as autorizações atuais. Isso permite testar o recurso de OAuth granular.
Desinstalar um complemento não publicado
Para desinstalar um complemento não publicado, siga estas etapas:
- Abra o projeto de script no editor do Apps Script.
- Selecione Implantar > Testar implantações.
- Selecione Desinstalar.
- Na parte de baixo, selecione Concluído.
Essas etapas removem a implantação, e o complemento não aparece mais. É possível reinstalar a implantação a qualquer momento.
Práticas recomendadas para testes
Ao testar o complemento, siga as práticas recomendadas. Além disso, faça o seguinte:
Teste os fluxos de navegação do card em todos os aplicativos host que o complemento estende. Verifique o comportamento à medida que o usuário muda entre contextos e entre cards não contextuais e contextuais.
Use dados de teste de exemplo para avaliar o comportamento do complemento.
Se o complemento se conectar a uma API de terceiros, verifique se o serviço está acessível. Verifique se o complemento processa autorização e login corretamente.
Lide com condições de erro de forma adequada. Use cards de erro quando necessário.
Monitore a performance do complemento. Se o complemento ficar mais lento após uma mudança no código, talvez seja necessário revisar esse recurso.