Run test cases
Preview — Test cases
This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of theService Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see thelaunch stage descriptions.
This document describes how to run test cases for your integrations. For information about test cases, supported test configurations, and its limitations, seeIntroduction to test cases.
Before you begin
To get the permission that you need to run test cases, ask your administrator to grant you theApplication Integration Invoker (
roles/integrations.integrationInvoker) IAM role on your project. For more information about granting roles, seeManage access to projects, folders, and organizations.This predefined role contains the
integrations.googleapis.com/testCases.invokerpermission, which is required to run test cases.You might also be able to get this permission withcustom roles or otherpredefined roles.
- Ensure that you have a test case in the integration. For information about how to create a test case, seeCreate Test Cases.
Run a test case
To run a test case, select one of the following options:Console
- In the Google Cloud console, go to theApplication Integration page.
- In the navigation menu, clickIntegrations.
TheIntegrations page appears listing all the integrations available in the Google Cloud project.
- Select an existing integration for which you want to create a test.
This opens the integration in theintegration editor.
- ClickTest Case and then clickOpen test cases. TheTest Cases pane appears with a list of test cases for the current integration version.
- Select the test case that you want to run.
In the Integration editor page, the designer canvas displaysTest case mode is active.
- ClickTest. TheRun test case page appears. Then, do the following:
- Enter theExecution deadline.
- ClickRun test.
You can view logs for your test cases. To view and inspect theexecution logs of the test run, clickView logs.
API
Call theprojects.locations.integrations.versions.testCases.executeTest method and provide any relevant parameters. For example:
POST https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases/TEST_CASE_ID:executeTestReplace the following:
PROJECT_ID: the ID of the Google Cloud projectLOCATION: the region where the integration is locatedINTEGRATION_NAME: the name of the integrationINTEGRATION_VERSION: the version of the integrationTEST_CASE_ID: the ID of the test case that you want run
View test case execution logs
You can view the test case executions logs on theLogs page. For information about how to view the logs, seeView execution logs in Application Integration.
What's next
- Learn abouttest cases.
Learn how to do the following:
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.