Testar e depurar complementos do Google Workspace no Apps Script

Quando você publica um complemento, os usuários podem instalá-lo pelo aplicativo host ou o Google Workspace Marketplace. Antes de publicar, teste a que você desenvolve nos aplicativos hospedeiros elas se estendem.

Esta página descreve como instalar um complemento em desenvolvimento (chamado de anúncio não publicado ou desenvolvedor ou complemento) para testes ou para uso pessoal. Também é possível depurar complementos usando o Apps Script Depurador e pontos de interrupção do ambiente de desenvolvimento integrado.

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 a permissão de editor o acesso ao projeto de script. Para detalhes sobre como conceder acesso, consulte Como colaborar com outros desenvolvedores.

Instalar um complemento não publicado

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

Siga estas etapas para instalar uma publicação não publicada Complemento do Google Workspace para teste:

  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.

Para permitir que outros usuários testem o complemento, compartilhe o projeto do Apps Script à conta (o acesso para edição é necessário). Em seguida, solicite que os usuários siga as etapas acima.

Depois de instalado, o complemento fica imediatamente disponível nos aplicativos hospedeiros se estende. Talvez seja necessário atualizar a guia do aplicativo host antes de ativar o complemento aparece. Você também deve 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 aparece mais. em qualquer aplicativo host. É possível reinstalar a implantação a qualquer momento Repita o procedimento de instalação.

Práticas recomendadas de teste

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

  1. Teste o fluxo de navegação de cartões em todos os aplicativos host . Verificar se o comportamento do complemento está correto conforme o usuário avança do contexto ao contexto e entre os cards contextuais e não contextuais.

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

  3. Caso seu complemento se conecte a uma API ou outro serviço de terceiros, verifique que o serviço possa ser acessado e se comporte como esperado. Confirme se seu complemento está lidando com detalhes de autorização e login corretamente.

  4. Verifique se todas as condições de erro foram processadas corretamente. Usar cards de erro quando necessário.

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