Testar os complementos do Google Workspace

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Quando você publica um complemento, os usuários podem instalá-lo usando o aplicativo host ou o Google Workspace Marketplace. No entanto, antes da publicação, é útil testar 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 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 da organização testem o complemento, conceda a elas acesso de editor ao projeto de script. Para ver detalhes sobre como conceder acesso, consulte Como colaborar com outros desenvolvedores.

Instalar um complemento não publicado

Você pode instalar complementos não publicados pela caixa de diálogo Implantações do Apps Script.

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

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

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

Depois de instalado, o complemento fica imediatamente disponível nos aplicativos host. 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:

  1. Abra o projeto do script no editor do Apps Script.
  2. Clique em Implantar > Implantar 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 aparece 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 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 estende. Confira se o comportamento do complemento está correto conforme o usuário alterna entre o contexto e os cards não contextuais e contextuais.

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

  3. Caso seu complemento se conecte 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 no desempenho do complemento. Se você fizer uma alteração no código e o complemento começar a ficar lento, talvez seja necessário remover ou retrabalhar esse recurso.