Lihat konektor yang didukung untuk Application Integration.
Memanggil tugas REST Endpoint
Tugas Call REST Endpoint memungkinkan Anda memanggil REST API pihak ketiga dari integrasi Anda. Respons dari panggilan REST API akan tersedia untuk Anda dalam variabel integrasi dan dapat digunakan di tugas downstream lainnya.
Sebelum memulai
- Agar terhubung ke endpoint autentikasi untuk panggilan REST API, pastikan Anda telah membuat profil OAuth 2.0 atau melampirkan akun layanan yang dikelola pengguna ke integrasi Anda. Jika API Anda tidak memerlukan autentikasi, kolom Authentication profile di panel konfigurasi tugas boleh dibiarkan kosong. Untuk melihat daftar konfigurasi, lihat Properti konfigurasi.
Jika integrasi Anda memiliki profil OAuth 2.0 dan akun layanan yang dikelola pengguna yang dikonfigurasi, maka secara default profil OAuth 2.0 digunakan untuk autentikasi. Jika profil OAuth 2.0 atau akun layanan yang dikelola pengguna tidak dikonfigurasi, eksekusi akan gagal.
- Jika integrasi Anda memiliki akun layanan yang terkait, berikan peran IAM yang diperlukan ke akun layanan tersebut berdasarkan URL endpoint REST. Misalnya, jika URL endpoint REST Anda memanggil layanan Cloud Storage, berikan peran IAM yang diperlukan untuk layanan Cloud Storage.
Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.
- Pastikan Kontrol Layanan VPC TIDAK disiapkan untuk Application Integration di project Google Cloud Anda.
Mengonfigurasi tugas Call REST Endpoint
Untuk mengonfigurasi tugas Call REST Endpoint:
- Di konsol Google Cloud, buka halaman Application Integration.
- Di menu navigasi, klik Integrasi.
Halaman Integrations akan muncul dan 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 Create Integration.
- Pilih region untuk integrasi.
- Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
- Klik dan tempatkan elemen Call REST Endpoint di editor integrasi.
- Klik elemen Call REST Endpoint pada desainer untuk melihat panel konfigurasi tugas Call REST Endpoint.
- Konfigurasikan kolom yang ditampilkan menggunakan properti konfigurasi tugas seperti yang dijelaskan dalam tabel di bawah.
Perubahan pada properti disimpan secara otomatis.
Properti konfigurasi
Tabel berikut menjelaskan properti konfigurasi tugas Call REST Endpoint.
Properti | Data type | Deskripsi |
Label | String | Opsional: tambahkan label untuk tugas Anda. |
Authentication | String | Opsional: mengonfigurasi dan menyimpan detail autentikasi untuk koneksi ke sistem eksternal. Untuk informasi selengkapnya, lihat Membuat profil autentikasi di Application Integration. |
URL dasar endpoint | String | URL endpoint REST tanpa parameter kueri. |
Metode HTTP | NA | metode HTTP yang akan digunakan.
Anda dapat memilih salah satu metode HTTP berikut:
|
Parameter string kueri URL | Kunci string kueri : String
Nilai: String |
Parameter kueri yang diperlukan untuk panggilan REST API.
Parameter kueri berbentuk key-value pair dengan kunci adalah nama kunci dan nilainya adalah nilai kunci yang sesuai. Anda dapat memasukkan lebih dari satu pasangan nilai kunci dengan mengklik ikon plus. |
Header HTTP | Kunci header HTTP: String
Nilai: String |
Header HTTP yang diperlukan untuk panggilan REST API.
Header HTTP berupa key-value pair dengan kunci adalah nama kunci dan nilainya adalah nilai kunci yang sesuai. Anda dapat memasukkan lebih dari satu pasangan nilai kunci dengan mengklik ikon plus. |
Mengikuti pengalihan | Boolean | Mengikuti pengalihan URL.
Anda dapat memilih salah satu nilai:
|
Tugas akan gagal saat terjadi error HTTP | Boolean | Strategi penanganan pengecualian saat panggilan REST API gagal.
Call REST Endpoint akan gagal jika kode respons HTTP adalah 4xx atau 5xx . Untuk mengetahui daftar kode error, lihat Kode error. Untuk kode respons HTTP lainnya, tampilkan kode error dan pesan error dalam respons.
Anda dapat memilih salah satu nilai:
|
Header respons (<Task name>) | String | Header respons yang tidak dikompresi dari respons REST API. |
Isi respons (<Task name>) | String | Isi respons yang tidak dikompresi dari respons REST API. |
Status respons (<Nama tugas>) | String | Kode respons HTTP dan teks kode yang sesuai dari respons REST API. |
Praktik terbaik
Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Call REST Endpoint, lihat Batas penggunaan.
Strategi penanganan error
Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.
Untuk mempelajari cara menangani strategi percobaan ulang untuk error 4xx
atau 5xx
, lihat blog Cara mencoba lagi Tugas Pemanggil Istirahat berdasarkan Status Respons.