Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu Cloud Pub/Sub

Pemicu Cloud Pub/Sub memungkinkan Anda menjalankan integrasi berdasarkan peristiwa di middleware Pub/Sub.

Dengan pemicu ini, Anda dapat menjalankan integrasi setiap kali penayang menulis pesan ke topik yang Anda pilih. Topik dapat berada di project Google Cloud yang sama dengan integrasi, atau di project Google Cloud yang berbeda. Saat dieksekusi, pemicu ini juga akan menulis pesan yang dipublikasikan ke variabel output CloudPubSubMessage. Berdasarkan persyaratan, Anda dapat menggunakan variabel ini di pemicu atau tugas downstream.

Untuk mempelajari cara membuat contoh integrasi menggunakan Integrasi Aplikasi dan pemicu Cloud Pub/Sub, lihat Mendengarkan topik Cloud Pub/Sub dan mengirim email.

Sebelum memulai

Pastikan Anda melakukan tugas berikut di project Google Cloud sebelum mengonfigurasi pemicu Cloud Pub/Sub.

• Tetapkan Project IAM Admin (roles/resourcemanager.projectIamAdmin) kepada pengguna yang membuat pemicu ini.
• Aktifkan Pub/Sub API untuk project Google Cloud yang memiliki integrasi Anda.
• Pastikan Anda memiliki topik Pub/Sub. Untuk membuat topik Pub/Sub baru:
  1. Buka halaman topik Pub/Sub di Konsol Cloud.

     Buka halaman topik Pub/Sub

  2. Klik Buat topik.
  3. Di kolom Topic ID, berikan nama topik yang unik.
  4. Klik Simpan.
  Catatan: Anda tidak perlu membuat langganan agar pemicu berfungsi. Integrasi Aplikasi akan otomatis membuat langganan untuk suatu topik saat Anda memublikasikan integrasi, dan Anda dapat melihat semua langganan di halaman langganan Pub/Sub.

  Mulai rilis Integrasi Aplikasi 01 Desember 2023, Anda akan ditagih untuk langganan sesuai dengan tarif penagihan Pub/Sub. Langganan untuk pemicu Cloud Pub/Sub yang ada akan terus berfungsi seperti sebelumnya, dan tidak ditagih. Namun, jika Anda memperbarui topik pemicu Cloud Pub/Sub yang ada, penagihan Pub/Sub akan diterapkan ke pemicu Cloud Pub/Sub yang diperbarui.

Untuk mengetahui informasi selengkapnya tentang cara mengelola akses menggunakan peran IAM, lihat Kontrol akses.

Untuk mengetahui informasi tentang cara memberikan peran kepada akun utama, lihat Memberikan, mengubah, dan mencabut akses.

Menambahkan pemicu Cloud Pub/Sub

Untuk menambahkan pemicu Cloud Pub/Sub ke integrasi baru atau yang sudah ada, ikuti langkah-langkah di bawah:

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

   Buka Application Integration

2. Di menu navigasi, klik Integrations

   Halaman Daftar 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.
      Catatan: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen pemicu Cloud Pub/Sub ke desainer.

Mengonfigurasi pemicu Cloud Pub/Sub

Klik elemen Pemicu Cloud Pub/Sub di editor integrasi untuk melihat panel konfigurasi pemicu, lalu lakukan tugas berikut:

1. Tentukan topik yang harus diproses pemicu di kolom Pub/Sub topic dalam format berikut:

   projects/PROJECT_ID/topics/TOPIC_ID

   Untuk melihat semua topik yang tersedia di project Google Cloud Anda, lihat kolom Nama topik di Topik. Anda juga dapat memilih topik dari project Google Cloud yang berbeda.

   Ganti kode berikut:
   • PROJECT_ID: project Google Cloud tempat topik Anda dibuat.
   • TOPIC_ID: ID topik Pub/Sub Anda. Topik dapat berada di project Google Cloud yang sama dengan project integrasi Anda, atau dapat berada di project Google Cloud yang berbeda.
2. Pilih akun layanan yang ingin Anda gunakan untuk memanggil integrasi. Anda juga dapat memilih variabel konfigurasi yang telah Anda buat dalam integrasi. Nilai variabel konfigurasi harus berupa alamat email akun layanan dengan format berikut: [e-mail]. Misalnya, [e-mail].

   Untuk mengetahui informasi tentang cara membuat variabel konfigurasi, lihat membuat variabel, dan tentang cara membuat akun layanan, lihat Membuat akun layanan.

   Jika memilih variabel konfigurasi, Anda harus memberikan peran yang diperlukan ke akun layanan yang dirujuk oleh variabel konfigurasi. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Peran IAM yang diperlukan.

   Jika tidak ada akun layanan, buat akun layanan dengan mengklik Buat baru di daftar Akun layanan.

   Catatan: Mulai rilis Integrasi Aplikasi 01 Desember 2023, saat mengonfigurasi pemicu Cloud Pub/Sub, Anda harus menentukan akun layanan untuk pemicu tersebut. Pemicu Pub/Sub yang ada, yang tidak memiliki akun layanan yang terkait, akan terus berfungsi seperti sebelumnya. Namun, jika ingin mengubah pemicu Pub/Sub yang ada, Anda harus mengonfigurasi akun layanan untuk terus menggunakan pemicu tersebut.

Secara default, opsi periode habis masa berlaku untuk langganan disetel ke never expire. Jika Anda ingin menetapkan masa berlaku ke nilai lain, di konsol Google Cloud, buka halaman langganan Pub/Sub dan edit langganan.

Peran IAM yang diperlukan untuk akun layanan

Mengklik Berikan saat memilih akun layanan akan otomatis memberikan peran berikut ke berbagai akun layanan.

Akun layanan	Peran IAM diberikan
Akun layanan default Integrasi Aplikasi: [e-mail]	Pub/Sub Editor (roles/pubsub.editor) (roles/iam.serviceAccountUser) Pengguna Akun Layanan Jika project Google Cloud topik Pub/Sub berbeda dengan project Google Cloud integrasi, akun layanan default memerlukan peran Pub/Sub Editor di project Google Cloud topik.
Akun layanan yang Anda pilih untuk pemicu ini	Application Integration Invoker (roles/integrations.integrationInvoker)

Output Pemicu

Untuk setiap peristiwa, pemicu Cloud Pub/Sub menghasilkan variabel output CloudPubSubMessage yang dapat Anda gunakan dalam tugas downstream. Variabel ini dalam format JSON dan memiliki struktur PubsubMessage.

Pertimbangan

• Ukuran maksimum pesan Pub/Sub adalah 10 MB. Untuk memahami semua batasan Pub/Sub, lihat Kuota dan batas Pub/Sub.
• Ada kemungkinan Pub/Sub menulis pesan yang sama lebih dari sekali ke sebuah topik. Untuk memahami perilaku Pub/Sub ini, lihat Pengiriman Minimal Satu Kali. Oleh karena itu, Anda harus mendesain integrasi agar bersifat idempoten sehingga tidak mengizinkan pesan ditulis lebih dari sekali ke suatu topik.

  Kolom message_id di header pesan secara unik mengidentifikasi pesan Pub/Sub.

• Jika Anda membatalkan publikasi integrasi, langganan Pub/Sub tidak akan dihapus untuk mencegah hilangnya pesan. Namun, jika Anda menghapus versi yang dipublikasikan atau semua versi integrasi dari suatu integrasi, langganan Pub/Sub juga akan dihapus.

Membuat langganan dengan filter untuk integrasi Anda

Jika Anda ingin menetapkan filter untuk langganan Pub/Sub guna memproses peristiwa tertentu dalam integrasi, ikuti langkah-langkah berikut:

1. Publikasikan integrasi dengan pemicu Cloud Pub/Sub yang dikonfigurasi. Langkah ini akan membuat langganan di project integrasi.
2. Di konsol Google Cloud, buka halaman Langganan.

   Buka Langganan

3. Buka langganan dan salin semua detailnya, termasuk nama langganan.
4. Hapus langganan yang ada.
5. Buat langganan baru dengan semua detail langganan yang dihapus, termasuk nama langganan, yang Anda salin di langkah 3 dan juga tambahkan filter di langganan baru.

   Langganan yang baru dibuat akan memicu integrasi dengan pesan yang difilter.

Pengecualian SLA

Pemicu Cloud Pub/Sub bergantung pada produk Pub/Sub. Karena dependensi ini bersifat eksternal terhadap Integrasi Aplikasi, persyaratan dan ketentuan Perjanjian Tingkat Layanan (SLA) Integration Aplikasi hanya berlaku jika pemicu Cloud Pub/Sub berhasil memulai eksekusi integrasi active.

Harga

Pemicu Cloud Pub/Sub dan pemicu Salesforce tidak mengharuskan Anda membuat konektor. Namun, jika Anda menggunakan Tugas konektor untuk terhubung ke Pub/Sub atau Salesforce, Anda akan ditagih untuk penggunaan konektor. Untuk mengetahui informasi tentang harga, lihat Harga Integrasi Aplikasi.

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.