Lihat konektor yang didukung untuk Integration Aplikasi.
Pemicu API
Pemicu API digunakan untuk langsung memanggil eksekusi untuk integrasi. Pemicu API dapat digunakan dalam mode sinkron atau asinkron.
Anda dapat menetapkan payload permintaan dan respons untuk pemicu API dengan membuat variabel dalam integrasi. Untuk informasi tentang cara membuat integrasi dengan pemicu API yang menerima permintaan API untuk mengambil informasi pelanggan, lihat tutorial fulfillment API.
Menambahkan pemicu API
Untuk menambahkan pemicu pemicu API, lakukan langkah-langkah berikut:- Di konsol Google Cloud, buka halaman Integrasi Aplikasi.
- Di menu navigasi, klik Integrations
Halaman Daftar 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 integrasi di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
- Klik dan tempatkan elemen pemicu API ke desainer.
Mengonfigurasi pemicu API
Klik elemen Pemicu API di editor integrasi untuk melihat panel konfigurasi pemicu.
Panel konfigurasi menampilkan ID Pemicu, yang merupakan ID yang dihasilkan mesin dalam format api_trigger/TRIGGER_NAME
.
Tidak diperlukan konfigurasi lebih lanjut untuk pemicu ini.
Memanggil pemicu API dari aplikasi
Setelah memublikasikan integrasi yang memiliki pemicu API yang dikonfigurasi, Anda dapat menggunakan metodeprojects.locations.integrations.execute
untuk memanggil pemicu tersebut dari aplikasi apa pun. Metode ini memicu eksekusi dalam mode sinkron.
Sintaks
curl -X POST \ -H "authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Server-Timeout: TIMEOUT_SECONDS" \ -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \ "https://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"
Ganti kode berikut:
TIMEOUT_SECONDS
: Waktu tunggu dalam detik untuk panggilan API. Secara default, waktu tunggunya adalah 120 detik. Untuk mengetahui daftar kumpulan parameter permintaan standar, lihat Parameter sistem.TRIGGER_NAME
: Nama pemicu API dalam integrasi Anda.PROJECT_ID
: ID project Google Cloud Anda.LOCATION
: Lokasi project Google Cloud Anda.
Contoh
Contoh berikut memanggil integrasi di wilayah us-east1
yang berisi pemicu test_API_1
API di project Google Cloud demo-project
:
curl -X POST \ -H "authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" \ -H "X-Server-Timeout: 300" -d '{"trigger_id":"api_trigger/test_API_1"}' \ "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"
Pertimbangan
Saat menggunakan pemicu API, ukuran kumulatif semua variabel input dapat maksimal 8 MB. Jika ukurannya melebihi 8 MB, Integrasi Aplikasi tidak akan menjalankan integrasi dan Anda akan mendapatkan error.
Kuota dan batas
Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.
Langkah selanjutnya
- Pelajari semua tugas dan pemicu.
- Pelajari cara menguji dan memublikasikan integrasi.
- Pelajari penanganan error.
- Pelajari log eksekusi integrasi.