L'attività Integrazione chiamate ti consente di invocare o chiamare altre integrazioni create all'interno del tuo progetto Google Cloud.
L'attività Integrazione chiamate è utile in scenari in cui devi definire più piccole integrazioni (sub-integrazioni) controllate utilizzando un'integrazione principale (integrazione principale). Dopo aver eseguito una sottointegrazione, puoi anche leggere la risposta della sottointegrazione nell'integrazione principale.
Prima di iniziare
L'attività Integrazione chiamate utilizza l'attivatore API per identificare e chiamare altre integrazioni e sottointegrazioni. Pertanto, devi assicurarti che le integrazioni che vuoi chiamare siano configurate utilizzando l'attivatore API. Per informazioni sulla configurazione di un trigger API, consulta Trigger API.
Assicurati di aver allegato un account di servizio gestito dall'utente all'integrazione. Se per l'integrazione non è configurato un account di servizio gestito dall'utente, per impostazione predefinita viene utilizzato l'account di servizio predefinito (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) per l'autenticazione.
Assicurati che il tuo account di servizio abbia il ruolo IAM Application Integration Invoker. Per informazioni sulla concessione di ruoli a un account di servizio, vedi Gestire l'accesso agli account di servizio.
Configura l'attività di integrazione chiamate
Per configurare l'attività Integrazione chiamate:
Nella Google Cloud console, vai alla pagina Application Integration.
Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.
Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
Inserisci un nome e una descrizione nel riquadro Crea integrazione.
Seleziona una regione per l'integrazione.
Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro infoRiepilogo dell'integrazione nella barra degli strumenti di integrazione.
Fai clic su Crea. L'integrazione appena creata si apre nell'editor di integrazione.
Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
Fai clic e posiziona l'elemento Chiama integrazione nell'editor di integrazione.
Fai clic sull'elemento attività Integrazione chiamate nel designer per visualizzare il riquadro di configurazione dell'attività Integrazione chiamate.
Configura i seguenti dettagli dell'integrazione secondaria:
ID trigger API: digita l'ID trigger API dell'integrazione che vuoi chiamare. Puoi chiamare una singola integrazione o più integrazioni con lo stesso ID attivatore.
Esegui tutte le integrazioni con questo ID trigger API:seleziona questa opzione per chiamare tutte le integrazioni
che hanno lo stesso ID trigger dell'API.
Ad esempio, se le integrazioni A e B hanno lo stesso ID trigger dell'API, vengono eseguite entrambe.AB
Esegui una singola integrazione: seleziona questa opzione per chiamare solo l'integrazione specificata nel campo
Nome integrazione. Puoi accedere e mappare la risposta della sottointegrazione
configurando i campi descritti in Mappa le variabili di risposta della sottointegrazione.
Strategia di esecuzione:seleziona le modalità di esecuzione per le sottointegrazioni che vuoi chiamare.
SYNC: esegue la sottointegrazione in modalità sincrona. In questa modalità, l'integrazione principale
attende il completamento delle sottointegrazioni prima di continuare con le attività a valle.
ASYNC: esegue la sottointegrazione in modalità asincrona. In questa modalità, l'integrazione principale
non attende il completamento delle sottointegrazioni. Immediatamente dopo aver chiamato le integrazioni secondarie, l'integrazione principale esegue le attività a valle.
Se questa opzione è selezionata, imposta il Ritardo di esecuzione (in millisecondi). Se impostato, specifica il ritardo di tempo fino all'esecuzione dell'integrazione.
Tutte le modifiche alle proprietà vengono salvate automaticamente.
Mappa le variabili di risposta della sottointegrazione
La tabella seguente descrive le proprietà di configurazione per mappare le variabili tra l'integrazione principale e le sottointegrazioni:
Proprietà
Descrizione
Map to sub-integration input(s)
Mappa i valori dall'integrazione principale all'integrazione secondaria. Questo campo accetta valori sotto forma di coppie chiave-valore, dove la chiave è una variabile nell'integrazione principale e il valore è la variabile di input corrispondente nella sottointegrazione.
Ad esempio, se vuoi mappare la variabile productID dell'integrazione principale alla variabile di sottointegrazione subIntProductID, selezionate productID dal campo Variabile di integrazione da cui eseguire la mappatura e inserisci subIntProductID nel campo Input di sottointegrazione.
Map values to sub-integration output(s)
Mappa le variabili di output della sottointegrazione alle variabili di integrazione principali.
Fai clic su Output della sottointegrazione da cui eseguire la mappatura e seleziona la
sottointegrazione. Fai clic su Variabile di integrazione a cui eseguire la mappatura e seleziona la variabile di integrazione principale corrispondente.
Best practice
Per informazioni sui limiti di utilizzo che si applicano all'attività Integrazione chiamate, consulta Limiti di utilizzo.
Strategia di gestione degli errori
Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non va a buon fine a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e sui diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.
Quote e limiti
Per informazioni su quote e limiti, consulta Quote e limiti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 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)."]]
