Tugas Integrasi Panggilan memungkinkan Anda memanggil atau memanggil integrasi lain yang dibuat dalam project Google Cloud Anda.
Tugas Integrasi Panggilan berguna dalam skenario saat Anda perlu menentukan beberapa integrasi kecil (sub-integrasi) yang dikontrol menggunakan integrasi utama (integrasi induk). Setelah menjalankan sub-integrasi, Anda juga dapat
membaca respons sub-integrasi di integrasi utama.
Sebelum memulai
Tugas Integrasi Panggilan menggunakan pemicu API untuk mengidentifikasi dan memanggil integrasi dan sub-integrasi lainnya. Oleh karena itu, Anda harus memastikan bahwa integrasi yang ingin Anda panggil dikonfigurasi menggunakan pemicu API. Untuk informasi tentang cara mengonfigurasi pemicu API, lihat Pemicu API.
Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, secara default akun layanan default (service-PROJECT_NUMBER@gcp-sa-integrations.) akan digunakan untuk autentikasi.
Pastikan akun layanan Anda memiliki peran IAM Application Integration Invoker. Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.
Mengonfigurasi tugas Integrasi Panggilan
Untuk mengonfigurasi tugas Integrasi Panggilan:
Di Google Cloud console, buka halaman Application Integration.
Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.
Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
Masukkan nama dan deskripsi di panel Buat Integrasi.
Pilih region untuk integrasi.
Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasiinfo di toolbar integrasi.
Klik Buat. Integrasi yang baru dibuat akan terbuka di editor integrasi.
Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
Klik dan tempatkan elemen Call Integration di editor integrasi.
Klik elemen tugas Call Integration di desainer untuk melihat panel konfigurasi tugas
Call Integration.
Konfigurasikan detail sub-integrasi berikut:
ID Pemicu API: Ketik ID pemicu API integrasi yang ingin Anda panggil. Anda dapat memanggil satu integrasi atau beberapa integrasi dengan ID pemicu yang sama.
Jalankan semua integrasi dengan ID Pemicu API ini: Pilih opsi ini untuk memanggil semua integrasi yang memiliki ID Pemicu API yang sama.
Misalnya, jika integrasi A dan integrasi B memiliki ID Pemicu API yang sama, integrasi A dan B akan dijalankan.
Jalankan satu integrasi: Pilih opsi ini untuk hanya memanggil integrasi yang ditentukan di kolom Nama integrasi. Anda dapat mengakses dan memetakan respons dari sub-integrasi dengan mengonfigurasi kolom yang dijelaskan dalam Memetakan variabel respons sub-integrasi.
Strategi eksekusi: Pilih mode eksekusi untuk sub-integrasi yang ingin Anda panggil.
SYNC: Menjalankan sub-integrasi dalam mode sinkron. Dalam mode ini, integrasi utama
menunggu sub-integrasi selesai sebelum melanjutkan tugas downstream.
ASYNC: Menjalankan sub-integrasi dalam mode asinkron. Dalam mode ini, integrasi utama
tidak menunggu sub-integrasi selesai. Segera setelah memanggil subintegrasi, integrasi utama akan menjalankan tugas downstream.
Jika opsi ini dipilih, tetapkan Penundaan eksekusi (dalam milidetik). Jika ditetapkan, ini akan menentukan
jeda waktu hingga integrasi dijalankan.
Semua perubahan pada properti akan disimpan secara otomatis.
Memetakan variabel respons sub-integrasi
Tabel berikut menjelaskan properti konfigurasi untuk memetakan variabel antara integrasi utama dan sub-integrasi:
Properti
Deskripsi
Map to sub-integration input(s)
Memetakan nilai dari integrasi utama ke sub-integrasi. Kolom ini menggunakan
nilai dalam bentuk pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi utama, dan
nilai adalah variabel input yang sesuai dalam sub-integrasi.
Misalnya, jika Anda ingin memetakan variabel productID integrasi utama ke variabel sub-integrasi subIntProductID, pilih productID dari kolom Variabel integrasi untuk dipetakan dari dan masukkan subIntProductID di kolom Input sub-integrasi untuk dipetakan ke.
Map values to sub-integration output(s)
Memetakan variabel output sub-integrasi ke variabel integrasi utama.
Klik Output sub-integrasi untuk memetakan, lalu pilih sub-integrasi. Klik Variabel integrasi yang akan dipetakan, lalu pilih variabel integrasi utama yang sesuai.
Praktik terbaik
Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Integrasi Panggilan, lihat Batas penggunaan.
Strategi penanganan error
Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan untuk mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.
Kuota dan batas
Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
