A tarefa Integração de chamadas permite invocar ou chamar outras integrações criadas no seu projeto do Google Cloud.
A tarefa Integração de chamadas é útil em cenários em que você precisa definir várias pequenas integrações (subintegrações) que são controladas usando uma integração principal (integração pai). Depois de executar uma subintegração, também é possível
ler a resposta da subintegração na integração principal.
Antes de começar
A tarefa Chamar a integração usa o acionador da API para identificar e chamar outras integrações e subintegrações. Portanto, você precisa garantir que as integrações que você quer chamar sejam configuradas usando o acionador de API. Para informações sobre como configurar um gatilho de API, consulte Gatilho da API.
Verifique se você anexou uma conta de serviço gerenciada pelo usuário à integração. Se a integração não tiver uma conta de serviço gerenciada pelo usuário configurada, a conta de serviço padrão (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) será usada para autenticação por padrão.
Verifique se a conta de serviço tem o papel do IAM Invocador do Application Integration. Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.
Configurar a tarefa "Integração de chamadas"
Para configurar a tarefa Chamar Integração:
No console Google Cloud , acesse a página Integração de aplicativos.
A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração ou clique em Criar integração para criar uma nova.
Caso você esteja criando uma nova integração, siga estas etapas:
Insira um nome e uma descrição no painel Criar integração.
Selecione uma região para a integração.
Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel infoResumo da integração na barra de ferramentas de integração.
Clique em Criar. A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
Clique e posicione o elemento Integração de chamadas no editor de integração.
Clique no elemento de tarefa Chamar Integração no designer para ver o painel de configuração da tarefa
Chamar Integração.
Configure os seguintes detalhes da subintegração:
ID do gatilho da API: digite o ID do gatilho da API da integração que você quer chamar. É possível chamar uma ou mais integrações com o mesmo código de gatilho.
Executar todas as integrações com esse ID do gatilho da API: selecione essa opção para chamar todas as integrações que têm o mesmo ID do gatilho da API.
Por exemplo, se a integração
A e B tiverem o mesmo
ID do gatilho da API, as duas integrações, A e B,
serão executadas.
Executar uma única integração: selecione essa opção para chamar apenas a integração especificada no campo Nome da integração. É possível acessar e mapear a resposta da subintegração
configurando os campos detalhados em Variáveis de resposta da subintegração do mapa.
Estratégia de execução: selecione os modos de execução para as subintegrações que você quer chamar.
SYNC: executa a subintegração no modo síncrono. Nesse modo, a integração principal
aguarda a conclusão das sub integrações antes de continuar as tarefas downstream.
ASYNC: executa a subintegração no modo assíncrono. Nesse modo, a integração principal
não aguarda a conclusão das sub integrações. Imediatamente após chamar as
subintegrações, a integração principal executa as tarefas downstream.
Se essa opção for selecionada, defina o Atraso da execução (em milissegundos). Quando definido, isso especifica o atraso até que a integração seja executada.
As alterações nas propriedades são salvas automaticamente.
Variáveis de resposta de subintegração de mapa
A tabela a seguir descreve as propriedades de configuração para mapear variáveis entre a integração principal e as subintegrações:
Propriedade
Descrição
Map to sub-integration input(s)
Mapeia valores da integração principal à subintegração. Esse campo usa
valores na forma de pares de chave-valor, em que a chave é uma variável na integração principal e
o valor é a variável de entrada correspondente na subintegração.
Por exemplo, se você quiser mapear a variável productID da integração principal para a
variável de subintegração subIntProductID,
selecione productID no campo variável de integração da qual mapear
e digite subIntProductID no campo Subintegração de entrada
a ser mapeada.
Map values to sub-integration output(s)
Mapeia as variáveis de saída da subintegração com as variáveis de integração principais.
Clique em Saída da subintegração a ser mapeada e selecione a
subintegração. Clique em Variável de integração para mapear e selecione a variável de integração principal correspondente.
Práticas recomendadas
Para informações sobre os limites de uso que se aplicam à tarefa Integração de chamadas, consulte Limites de uso.
Estratégia de solução de erros
A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar
devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
