En este documento se describe cómo ejecutar casos de prueba para sus integraciones. Para obtener información sobre los casos de prueba, las configuraciones de prueba admitidas y sus limitaciones, consulta el artículo Introducción a los casos de prueba.
Asegúrate de que tienes un caso de prueba en la integración. Para obtener información sobre cómo crear un caso de prueba, consulta Crear casos de prueba.
Ejecutar un caso de prueba
Para ejecutar un caso de prueba, selecciona una de las siguientes opciones:
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-11 (UTC)."],[[["\u003cp\u003eThis document guides you through running test cases for Application Integration, providing instructions for both the Google Cloud console and API methods.\u003c/p\u003e\n"],["\u003cp\u003eBefore running test cases, you must have the \u003ccode\u003eApplication Integration Invoker\u003c/code\u003e IAM role to obtain the necessary \u003ccode\u003eintegrations.googleapis.com/testCases.invoker\u003c/code\u003e permission, and you also must ensure a test case exists within the integration.\u003c/p\u003e\n"],["\u003cp\u003eYou can run a test case by navigating to the Application Integration page in the Google Cloud console, selecting an integration, and then choosing a test case from the "Test Cases" pane, where you can set an execution deadline.\u003c/p\u003e\n"],["\u003cp\u003eTest cases can also be run via the API by calling the \u003ccode\u003eprojects.locations.integrations.versions.testCases.executeTest\u003c/code\u003e method with relevant parameters like the project ID, location, integration name, version, and test case ID.\u003c/p\u003e\n"],["\u003cp\u003eYou can access and review the execution logs of your test runs via the "Logs" page to examine the results and debug any issues.\u003c/p\u003e\n"]]],[],null,["# Run test cases\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nRun test cases\n==============\n\n|\n| **Preview\n| --- Test cases**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document describes how to run test cases for your integrations. For information about test cases, supported test configurations, and its limitations, see [Introduction to test cases](/application-integration/docs/test-cases).\n\nBefore you begin\n----------------\n\n-\n\n To get the permission that\n you need to run test cases,\n\n ask your administrator to grant you the\n\n\n [Application Integration Invoker](/iam/docs/roles-permissions/integrations#integrations.integrationInvoker) (`roles/integrations.integrationInvoker`)\n IAM role on project.\n\n\n For more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\n This predefined role contains the\n ` integrations.googleapis.com/testCases.invoker`\n permission,\n which is required to\n run test cases.\n\n\n You might also be able to get\n this permission\n with [custom roles](/iam/docs/creating-custom-roles) or\n other [predefined roles](/iam/docs/roles-overview#predefined).\n- Ensure that you have a test case in the integration. For information about how to create a test case, see [Create Test Cases](/application-integration/docs/create-test-cases).\n\nRun a test case\n---------------\n\nTo run a test case, select one of the following options:\n\n### Console\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration for which you want to create a test. This opens the integration in the *integration editor*.\n\n4. Click **Test Case** and then click **Open test cases** . The **Test Cases** pane appears with a list of test cases for the current integration version.\n5. Select the test case that you want to run. In the Integration editor page, the designer canvas displays **Test case mode is active**.\n\n6. Click **play_circleTest** . The **Run test case** page appears. Then, do the following:\n 1. Enter the **Execution deadline**.\n 2. Click **Run test** .\n\n You can view logs for your test cases. To view and inspect the [execution logs](/application-integration/docs/integration-execution-logs) of the test run, click **View logs**.\n\n### API\n\nCall the [`projects.locations.integrations.versions.testCases.executeTest` method](/application-integration/docs/reference/rest/v1/projects.locations.integrations.versions.testCases/executeTest) and provide any relevant parameters. For example: \n\n```\nPOST https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases/TEST_CASE_ID:executeTest\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the Google Cloud project\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the region where the integration is located\n- \u003cvar translate=\"no\"\u003eINTEGRATION_NAME\u003c/var\u003e: the name of the integration\n- \u003cvar translate=\"no\"\u003eINTEGRATION_VERSION\u003c/var\u003e: the version of the integration\n- \u003cvar translate=\"no\"\u003eTEST_CASE_ID\u003c/var\u003e: the ID of the test case that you want run\n\nView test case execution logs\n-----------------------------\n\nYou can view the test case executions logs on the **Logs** page. For information about how to view the logs, see [View execution logs in Application Integration](/application-integration/docs/integration-execution-logs#view-integration-execution-logs).\n\nWhat's next\n-----------\n\n- Learn about [test cases](/application-integration/docs/test-cases).\n- Learn how to do the following:\n\n - [Create test cases](/application-integration/docs/create-test-cases).\n - [Configure test cases](/application-integration/docs/configure-test-cases).\n - [Copy](/application-integration/docs/manage-test-cases#copy) and [delete](/application-integration/docs/manage-test-cases#delete) test cases.\n - [Upload and download test cases](/application-integration/docs/upload-download-test-cases)."]]
