Prueba y depura complementos de Google Workspace de Apps Script
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando publicas un complemento, los usuarios pueden instalarlo a través de la aplicación host o Google Workspace Marketplace. Antes de publicarlos, prueba los complementos que desarrollas dentro de las aplicaciones host que extienden.
En esta página, se describe cómo instalar un complemento que está en desarrollo (llamado complemento no publicado o para desarrolladores) para pruebas o uso 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, otorgándoles acceso de editor al proyecto de secuencia de comandos. Para obtener detalles sobre cómo otorgar acceso, consulta Cómo colaborar con otros desarrolladores.
Instala un complemento no publicado
Puedes instalar complementos no publicados desde el diálogo Implementaciones de Apps Script.
Sigue estos pasos para instalar un complemento de Google Workspace no publicado y probarlo:
Abre el proyecto de secuencia de comandos en el editor de Apps Script.
Haz clic en Implementar > Implementaciones de prueba.
Haz clic en Install.
En la parte inferior, haz clic en Listo.
Para permitir que otros usuarios prueben el complemento, comparte el proyecto de Apps Script con su cuenta (se requiere acceso de edición). Luego, pídeles a los usuarios que sigan los pasos anteriores.
Una vez instalado, el complemento está disponible de inmediato en las aplicaciones de host que extiende. Es posible que debas actualizar la pestaña de la aplicación host antes de que aparezca el complemento. También debes autorizar el complemento antes de usarlo.
Desinstala un complemento no publicado
Para desinstalar una implementación de complemento no publicada, sigue estos pasos:
Abre el proyecto de secuencia de comandos en el editor de Apps Script.
Haz clic en Implementar > Implementaciones de prueba.
Haz clic en Desinstalar.
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 de host. Puedes reinstalar 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:
Prueba los flujos de navegación de la tarjeta en todas las aplicaciones de host a las que se extiende el complemento. Asegúrate de que el comportamiento del complemento sea correcto a medida que el usuario cambia de contexto y entre tarjetas contextuales y no contextuales.
Si tu complemento se conecta a una API de terceros o a otro servicio, verifica que se pueda acceder al servicio y que se comporte como se espera. Asegúrate de que el complemento controle correctamente los detalles de autorización y acceso.
Asegúrate de que se manejen correctamente las condiciones de error. Usa tarjetas de error cuando sea necesario.
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-12-22 (UTC)"],[[["\u003cp\u003eUnpublished Google Workspace add-ons can be installed for testing and personal use directly from the Apps Script project.\u003c/p\u003e\n"],["\u003cp\u003eUsers need editor access to the script project to install and test the unpublished add-on.\u003c/p\u003e\n"],["\u003cp\u003eUninstalling an unpublished add-on removes it from all host applications and requires reinstallation for further use.\u003c/p\u003e\n"],["\u003cp\u003eThorough testing is crucial, including card navigation, data handling, external service integrations, error management, and performance evaluation.\u003c/p\u003e\n"]]],["To test an unpublished add-on, open its script project in the Apps Script editor and navigate to **Deploy \u003e Test deployments**. Click **Install**, then **Done** to make it available in host applications. Share the project for others to test. Uninstall by repeating the process and selecting **Uninstall**. Testing should include card navigation, example data evaluation, third-party service verification, error handling, and performance monitoring.\n"],null,["# Test and debug Apps Script Google Workspace add-ons\n\nWhen you publish an add-on, users can install it\nthrough the host application\nor the [Google Workspace Marketplace](https://workspace.google.com/marketplace/). Before you publish, test the\nadd-ons that you develop within the host applications that\nthey extend.\n\nThis page describes how to install an add-on that is\nunder development (called an *unpublished* or *developer*\nadd-on) for testing or\npersonal use. You can also debug add-ons using the\nApps Script\nIDE's [debugger and breakpoints](/apps-script/guides/support/troubleshooting#use-debugger).\n\nPrerequisites\n-------------\n\n- You must have editor access to the add-on's script project.\n- To let other people in your organization test the add-on, grant them editor access to the script project. For details about granting access, see [Collaborating with Other Developers](/apps-script/guides/collaborating).\n\nInstall an unpublished add-on\n-----------------------------\n\nYou can install unpublished add-ons from Apps Script's **Deployments**\ndialog.\n\nFollow these steps to install an unpublished\nGoogle Workspace add-on for testing:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Install**.\n4. At the bottom, click **Done**.\n\nYou can let other users test the add-on by sharing the Apps Script project\nwith their account (edit access is required). Then prompt the users to\nfollow the above steps.\n\nOnce installed, the add-on is immediately available in host applications it\nextends. You may need to refresh the host application tab before the add-on\nappears. You must also\n[authorize](/workspace/add-ons/how-tos/authorizing-addons#authorizing_unpublished_g_suite_add-ons)\nthe add-on before using it.\n\nUninstall an unpublished add-on\n-------------------------------\n\nTo uninstall an unpublished add-on deployment, follow these steps:\n\n1. Open the script project in the Apps Script editor.\n2. Click **Deploy \\\u003e Test deployments**.\n3. Click **Uninstall**.\n4. At the bottom, click **Done**.\n\nThese steps immediately remove the deployment and the add-on no longer appears\nin any host application. You can reinstall the deployment at any time by\nrepeating the [install procedure](#install_an_unpublished_add-on).\n\nTesting best practices\n----------------------\n\nWhile testing your Google Workspace add-on, be sure\nto follow the\n[Best practices](/workspace/add-ons/guides/workspace-best-practices)\nfor add-on development. In addition, be sure to do the following:\n\n1. Test card navigation flows thoroughly in all the host applications the\n add-on extends. Make sure the add-on behavior is correct as the user moves\n from context to context, and between non-contextual and contextual cards.\n\n2. [Use example test data](/workspace/add-ons/guides/workspace-best-practices#_write_tests_and_test_messages)\n to evaluate your add-on's behavior.\n\n3. If your add-on connects to a third-party API or other service, verify\n that the service can be accessed and behaves as expected. Make sure\n your add-on is handling the\n [authorization and log-in details](/workspace/add-ons/how-tos/non-google-services)\n correctly.\n\n4. Make sure any error conditions are handled gracefully. [Use error cards](/workspace/add-ons/guides/workspace-best-practices#_use_error_cards)\n where needed.\n\n5. Pay attention to how performant the add-on is. If you make a change to the\n code and the add-on starts slowing down, you may need to remove or rework\n that feature."]]
