La tarea Integración de llamadas te permite invocar o llamar a otras integraciones creadas dentro de tu proyecto de Google Cloud.
La tarea Integración de llamadas es útil en situaciones en las que necesitas definir varias integraciones pequeñas (integraciones secundarias) que se controlan mediante una integración principal (integración superior). Después de ejecutar una integración secundaria, también puedes leer la respuesta de la integración secundaria en tu integración principal.
Antes de comenzar
La tarea Integración de llamadas usa el activador de APIs para identificar y llamar a otras integraciones y subintegraciones. Por lo tanto, debes asegurarte de que las integraciones a las que deseas llamar estén configuradas mediante el activador de APIs. Para obtener información sobre cómo configurar un activador de API, consulta Activador de API.
Asegúrate de que tu cuenta de servicio tenga el rol de IAM Invocador de Application Integration. Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulta Administra el acceso a las cuentas de servicio.
Configura la tarea Integración de llamadas
Para configurar la tarea Integración de llamadas, haz lo siguiente:
En la consola de Google Cloud , ve a la página Application Integration.
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones, en la que se enumeran todas las integraciones disponibles en el proyecto de Google Cloud.
Selecciona una integración existente o haz clic en Crear integración para crear una nueva.
Si creas una integración nueva, haz lo siguiente:
Ingresa un nombre y una descripción en el panel Crear integración.
Selecciona una región para la integración.
Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel infoResumen de la integración en la barra de herramientas de la integración.
Haz clic en Crear. La integración recién creada se abrirá en el editor de integración.
En la barra de navegación del editor de integración, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
Haz clic en el elemento Integración de llamadas y colócalo en el editor de integración.
Haz clic en el elemento de tarea Call Integration en el diseñador para ver el panel de configuración de la tarea Call Integration.
Configura los siguientes detalles de subintegración:
ID del activador de API: Escribe el ID del activador de la API de la integración a la que deseas llamar. Puedes llamar a una sola integración o a varias integraciones con el mismo ID de activador.
Ejecutar todas las integraciones en este ID de activador de API: Selecciona esta opción para llamar a todas las integraciones que tienen el mismo ID de activador de API.
Por ejemplo, si la integración A y la integración B, tienen el mismo ID del activador de la API, se ejecutan las integraciones A y B.
Run a single integration: selecciona esta opción para llamar solo a la integración especificada en el campo Integration name. Puedes acceder y asignar la respuesta de la integración secundaria mediante la configuración de los campos detallados en Mapea las variables de respuesta de integración secundaria.
Estrategia de ejecución: Selecciona los modos de ejecución para las integraciones secundarias a las que deseas llamar.
SYNC: Ejecuta la integración secundaria en modo síncrono. En este modo, la integración principal espera a que se completen las integraciones secundarias antes de continuar con las tareas descendentes.
ASYNC: Ejecuta la integración secundaria en modo asíncrono. En este modo, la integración principal no espera a que se completen las integraciones secundarias. Inmediatamente después de llamar a las integraciones secundarias, la integración principal ejecuta las tareas descendentes.
Si se selecciona esta opción, configura el Retraso de ejecución (en milisegundos). Cuando se establece, esto especifica el retraso de tiempo hasta que se ejecuta la integración.
Los cambios en las propiedades se guardan de forma automática.
Asigna variables de respuesta de integración secundaria
En la siguiente tabla, se describen las propiedades de configuración para asignar variables entre la integración principal y las secundarias:
Propiedad
Descripción
Map to sub-integration input(s)
Asigna valores de la integración principal a la integración secundaria. Este campo toma valores en forma de pares clave-valor, en los que la clave es una variable en la integración principal, y el valor es la variable de entrada correspondiente en la integración secundaria.
Por ejemplo, si deseas asignar la variable productID de la integración principal a la variable de integración secundaria subIntProductID, selecciona productID en el campo Integration variable to map from y, luego, ingresa subIntProductID en el campo Subintegration input to map to.
Map values to sub-integration output(s)
Asigna las variables de salida de integración secundaria a las variables de integración principal.
Haz clic en Subintegration output to map from y selecciona la integración secundaria. Haz clic en Variable de integración para asignar y selecciona la variable de integración principal correspondiente.
Prácticas recomendadas
Para obtener más información sobre los límites de uso que se aplican a la tarea Llamar a la integración, consulta Límites de uso.
Estrategia de manejo de errores
Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.
Cuotas y límites
Para obtener más información sobre las cuotas y los límites, consulta Cuotas y límites.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-25 (UTC)"],[[["\u003cp\u003eThe Call Integration task allows you to invoke other integrations within your Google Cloud project, enabling the creation of sub-integrations controlled by a parent integration.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Call Integration task, the integrations you intend to call must be configured with an API trigger, and the service account should have the Application Integration Invoker IAM role.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure the Call Integration task to run multiple integrations with the same API Trigger ID or run a single specific integration and map the response variables accordingly.\u003c/p\u003e\n"],["\u003cp\u003eThe Call Integration task supports synchronous (SYNC) and asynchronous (ASYNC) execution strategies for sub-integrations, allowing control over how the main integration interacts with the sub-integrations.\u003c/p\u003e\n"],["\u003cp\u003eYou can map input variables from the main integration to the sub-integration, and map sub-integration output variables to the main integration when running a single integration with a synchronous execution strategy.\u003c/p\u003e\n"]]],[],null,["# Call Integration task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nCall Integration task\n=====================\n\nThe **Call Integration** task lets you invoke or call other integrations created within your Google Cloud project.\n\nThe **Call Integration** task is useful in scenarios where you need to define multiple small integrations (sub-integrations) that is controlled using a main integration (parent integration). After running a sub-integration, you can also\nread the response of the sub-integration in your main integration.\n\nBefore you begin\n----------------\n\n- The **Call Integration** task uses the API trigger to identify and call other integrations and sub-integrations. Therefore, you must ensure that the integrations you want to call are configured using the API trigger. For information about configuring an API trigger see [API trigger](/application-integration/docs/configuring-api-trigger).\n- Ensure that you have [attached a user-managed service account](/application-integration/docs/access-control#add-service-account) to your integration. If your integration does not have user-managed service account configured, then by default the [default service account](/application-integration/docs/access-control#default-service-account) (`service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-sa-integrations.iam.gserviceaccount.com`) is used for authentication.\n- Ensure that your service account has the **Application Integration Invoker** IAM role. For information about granting roles to a service account, see [Manage access to service accounts](/iam/docs/manage-access-service-accounts).\n\nConfigure the Call Integration task\n-----------------------------------\n\nTo configure the **Call Integration** task:\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\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Call Integration** element in the integration editor.\n6. Click the **Call Integration** task element on the designer to view the **Call Integration** task configuration pane.\n7. Configure the following sub integration details:\n 1. **API Trigger ID:** Type the [API trigger ID](/application-integration/docs/configuring-api-trigger#configure-an-api-trigger) of the integration that you want to call. You can call a single integration or multiple integrations with the same trigger ID.\n 2. **Run all integrations with this API Trigger ID:** Select this option to call all the integrations that have the same API **Trigger ID** .\n\n\n For example, if integration\n `A` and integration `B`, have the same API\n **Trigger ID** , both the integrations `A` and `B`\n are run.\n\n\n | **Note** : If you select this option, the response from the sub-integrations will not be available in the main integration. If you want to access the response of the sub-integrations, select the **Run a single integration** option.\n 3. **Run a single integration** : Select this option to call only the integration specified in the **Integration name** field. You can access and map the response from the sub-integration by configuring the fields detailed in [Map sub-integration response variables](#params).\n\n\n 4. **Execution strategy:** Select the execution modes for the sub-integrations that you want to call.\n - **SYNC** : Runs the sub-integration in synchronous mode. In this mode, the main integration waits for the sub-integrations to complete before continuing with the downstream tasks.\n\n \u003cbr /\u003e\n\n - **ASYNC** : Runs the sub-integration in asynchronous mode. In this mode, the main integration does not wait for the sub-integrations to complete. Immediately after calling the sub integrations, the main integration runs the downstream tasks.\n\n\n If this option is selected, set the **Execution delay (in milliseconds)**. When set, this specifies the\n time delay until the integration is run.\n\n \u003cbr /\u003e\n\n\n All changes to the properties are saved automatically.\n\nMap sub-integration response variables\n--------------------------------------\n\nThe following table describes the configuration properties to map variables between the main integration and sub-integrations:\n\nBest practices\n--------------\n\nFor information about the usage limits that apply to the **Call Integration** task, see [Usage limits](/application-integration/docs/quotas#usage-limits).\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
