Prueba y depura complementos de Google Workspace de Apps Script

Cuando publicas un complemento, los usuarios pueden instalarlo a través de la aplicación host o de Google Workspace Marketplace. Antes de publicar, prueba los complementos que desarrolles en las aplicaciones host que extienden.

En esta página, se describe cómo instalar un complemento en desarrollo (llamado complemento sin publicar o para desarrolladores) para realizar pruebas o usarlo de forma personal. También puedes depurar complementos con el depurador y los puntos de interrupción del IDE de Apps Script.

Requisitos previos

  • Debes tener acceso de editor al proyecto de secuencia de comandos del complemento.
  • Para permitir que otras personas de tu organización prueben el complemento, otórgales acceso de editor al proyecto de secuencia de comandos. Para obtener detalles sobre cómo otorgar acceso, consulta Colaboración con otros desarrolladores.

Cómo instalar un complemento no publicado

Puedes instalar complementos no publicados desde el diálogo Deployments de Apps Script.

Sigue estos pasos para instalar un complemento de Google Workspace no publicado para realizar pruebas:

  1. Abre el proyecto de secuencia de comandos en el editor de Apps Script.
  2. Haz clic en Implementar > Implementaciones de prueba.
  3. Haz clic en Install.
  4. En la parte inferior, haz clic en Listo.

Puedes permitir que otros usuarios prueben el complemento compartiendo el proyecto de Apps Script con sus cuentas (se requiere acceso de edición). Luego, indícales a los usuarios que sigan los pasos anteriores.

Una vez instalado, el complemento estará disponible de inmediato en las aplicaciones host que extienda. Es posible que debas actualizar la pestaña de la aplicación host para que aparezca el complemento. También debes autorizar el complemento antes de usarlo. Si tu proyecto ya está autorizado, usa ScriptApp.invalidateAuth para invalidar las autorizaciones existentes y, así, poder probar la función de OAuth granular en tu complemento.

Cómo desinstalar un complemento no publicado

Para desinstalar una implementación de complemento no publicada, sigue estos pasos:

  1. Abre el proyecto de secuencia de comandos en el editor de Apps Script.
  2. Haz clic en Implementar > Implementaciones de prueba.
  3. Haz clic en Desinstalar.
  4. En la parte inferior, haz clic en Listo.

Estos pasos quitan la implementación de inmediato, y el complemento ya no aparece en ninguna aplicación host. Puedes volver a instalar la implementación en cualquier momento repitiendo el procedimiento de instalación.

Prácticas recomendadas para las pruebas

Mientras pruebas tu complemento de Google Workspace, asegúrate de seguir las prácticas recomendadas para el desarrollo de complementos. Además, asegúrate de hacer lo siguiente:

  1. Prueba a fondo los flujos de navegación de las tarjetas en todas las aplicaciones host que extiende el complemento. Asegúrate de que el comportamiento del complemento sea correcto a medida que el usuario se desplaza de un contexto a otro y entre tarjetas contextuales y no contextuales.

  2. Usa datos de prueba de ejemplo para evaluar el comportamiento de tu complemento.

  3. Si tu complemento se conecta a una API o a otro servicio de terceros, verifica que se pueda acceder al servicio y que funcione según lo previsto. Asegúrate de que tu complemento controle los detalles de autorización y acceso correctamente.

  4. Asegúrate de que las condiciones de error se controlen correctamente. Usa tarjetas de error cuando sea necesario.

  5. Presta atención al rendimiento del complemento. Si realizas un cambio en el código y el complemento comienza a ralentizarse, es posible que debas quitar o volver a trabajar esa función.