Bagian ini adalah ringkasan langkah-langkah untuk mengintegrasikan aplikasi Anda dengan Cloud Marketplace. Pada level tinggi, Anda mengintegrasikan aplikasi dengan Google Cloud dengan cara berikut:
Integrasi backend
Anda harus mengintegrasikan backend aplikasi dengan Google API dan layanan Google berikut:
Berintegrasi dengan Pub/Sub untuk menerima notifikasi dari Cloud Marketplace, seperti saat pengguna mendaftar ke produk Anda. Partner Engineer Anda akan membuat topik Pub/Sub yang harus Anda langgani untuk mendapatkan notifikasi.
Untuk informasi tentang cara berlangganan topik Pub/Sub, lihat Panduan Pelanggan Pub/Sub.
Berintegrasi dengan Partner Procurement API untuk membuat akun bagi pelanggan, dan menautkan akun ini dengan pembelian Cloud Marketplace mereka. Anda juga harus menggunakan Partner Procurement API untuk memperbarui akun tertaut saat pengguna mengubah atau membatalkan paket langganan mereka.
Jika Anda telah memilih model harga berbasis penggunaan, integrasikan dengan Service Control untuk melaporkan informasi penggunaan.
Untuk mengetahui informasi mendetail tentang cara mengintegrasikan backend aplikasi dengan Cloud Marketplace, lihat Mengonfigurasi backend aplikasi.
Untuk contoh integrasi backend produk dasar dengan Cloud Marketplace dan panduan kode contoh, lihat codelab untuk mengintegrasikan produk SaaS.
Integrasi frontend
Di frontend aplikasi, Anda harus menyiapkan integrasi berikut:
Berikan halaman pendaftaran untuk mendaftarkan akun bagi pelanggan baru yang membeli produk Anda melalui Cloud Marketplace. Saat pengguna mengunjungi halaman ini, Google akan mengirimkan Token Web JSON (JWT) yang berisi ID akun pengguna. Anda menggunakan ID akun ini untuk menautkan akun pengguna di produk Anda dengan Akun Google mereka, dan juga untuk Identity and Access Management (IAM).
Sediakan halaman login untuk pelanggan Anda.
Secara opsional, Anda dapat memilih untuk:
- Integrasikan single sign-on (SSO), sehingga pelanggan dapat login ke aplikasi Anda menggunakan Akun Google mereka. Jika Anda mengintegrasikan SSO, saat pengguna login menggunakan SSO, Google akan mengirimkan Token Web JSON (JWT) yang berisi informasi tentang pengguna untuk Anda verifikasi.
Untuk informasi mendetail tentang cara mengintegrasikan frontend aplikasi dengan Cloud Marketplace, lihat Mengintegrasikan frontend aplikasi.
Sebelum memulai
- Pastikan Partner Engineer Anda telah mengaktifkan akses ke Cloud Commerce Partner Procurement API. Setelah Partner Engineer memberi Anda akses ke Partner Procurement API, Anda tidak perlu melakukan langkah tambahan apa pun untuk mengaktifkan API di konsol Google Cloud.
Berintegrasi dengan Google API
Anda dapat mengintegrasikan aplikasi dengan Google API dengan menggunakan library klien, yang memberi Anda akses terprogram ke produk Google. Library klien tersedia untuk platform pengembangan yang paling populer, seperti Java, Python, dan .NET.
Instal library klien untuk platform Anda dari halaman Library Klien API. Dengan library klien, Anda dapat:
- Menghubungkan ke langganan Pub/Sub, dan menangani pesan masuk.
- Jika Anda memilih harga berbasis penggunaan, terhubung ke Service Control API untuk melaporkan data penggunaan ke Google.
Untuk membuat akun tertaut bagi pelanggan, serta mengirim dan menerima info terbaru tentang akun pengguna, Anda juga harus berintegrasi dengan Partner Procurement API. Karena Partner Procurement API dibatasi, Anda harus mem-build library klien baru untuk API.
Untuk mem-build library klien baru, Anda harus menginstal library klien Google, dan mem-build library baru dari dokumen penemuan API. Dokumen penemuan untuk Partner Procurement API ada di URL ini:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Misalnya, jika Anda mem-build library klien Python untuk
Partner Procurement API, gunakan metode
build(). Untuk kode contoh yang mem-build library klien, lihat
contoh codelab di GitHub.