Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas Call 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 dalam tugas downstream lainnya.

Sebelum memulai

  • Untuk 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 Profil autentikasi di panel konfigurasi tugas dapat 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, profil OAuth 2.0 akan digunakan untuk autentikasi secara default. Jika profil OAuth 2.0 atau akun layanan yang dikelola pengguna tidak dikonfigurasi, eksekusi akan gagal.

  • Jika integrasi Anda memiliki akun layanan yang terpasang, berdasarkan URL endpoint REST, berikan peran IAM yang diperlukan ke akun layanan tersebut. 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 Integrasi Aplikasi di project Google Cloud Anda.

Mengonfigurasi tugas Call REST Endpoint

Untuk mengonfigurasi tugas Call REST Endpoint:

  1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

    Buka Application Integration

  2. Di menu navigasi, klik Integrations.

    Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Buat Integrasi.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
    4. Klik Create.

    Tindakan ini akan membuka integrasi di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
  5. Klik dan tempatkan elemen Call REST Endpoint di editor integrasi.
  6. Klik elemen Call REST Endpoint di desainer untuk melihat panel konfigurasi tugas Call REST Endpoint.
  7. Konfigurasikan kolom yang ditampilkan menggunakan properti konfigurasi tugas seperti yang dijelaskan dalam tabel di bawah.

    Perubahan pada properti akan 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.
Autentikasi String Opsional: mengonfigurasi dan menyimpan detail autentikasi untuk koneksi ke sistem eksternal. Untuk mengetahui informasi selengkapnya, lihat Membuat profil autentikasi di Integrasi Aplikasi.
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:

  • HAPUS
  • DAPATKAN
  • HEAD
  • PATCH
  • POST
  • PUT
Parameter string kueri URL Kunci string kueri : String

Nilai: String

Parameter kueri yang diperlukan untuk panggilan REST API.

Parameter kueri dalam bentuk key-value pair dengan kunci adalah nama kunci dan nilai 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 pasangan nilai kunci dengan kunci adalah nama kunci dan nilai adalah nilai kunci yang sesuai. Anda dapat memasukkan lebih dari satu pasangan nilai kunci dengan mengklik ikon plus.

Mengikuti pengalihan Boolean Ikuti pengalihan URL.

Anda dapat memilih salah satu nilai:

  • Benar : Memanggil URL yang dialihkan jika URL dasar Endpoint diteruskan ke URL lain.
  • Salah: Tidak memanggil URL yang dialihkan jika URL dasar Endpoint diteruskan ke URL lain.
Tugas akan gagal jika terjadi error HTTP Boolean Strategi penanganan pengecualian saat panggilan REST API gagal. Call REST Endpoint 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:

  • Benar : Menampilkan pengecualian.
  • Salah: Tidak menampilkan pengecualian. Namun, kode error dan pesan error akan ditampilkan dalam respons.
Header respons (<Nama tugas>) String Header respons yang tidak dikompresi dari respons REST API.
Isi respons (<Nama tugas>) String Isi respons yang tidak dikompresi dari respons REST API.
Status respons (<Task name>) 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 mengetahui 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 ulang Tugas Pemanggil Rest berdasarkan Status Respons.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya