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 Anda dengan Google API dan layanan Google berikut:
Integrasikan dengan Pub/Sub untuk menerima notifikasi dari Cloud Marketplace, seperti saat pengguna mendaftar produk Anda. Partner Engineer membuat topik Pub/Sub yang harus Anda subscribe untuk mendapatkan notifikasi.
Untuk mendapatkan informasi tentang berlangganan topik Pub/Sub, lihat Panduan Pelanggan Pub/Sub.
Integrasikan 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 memilih model harga berbasis penggunaan, integrasikan dengan Kontrol Layanan untuk melaporkan informasi penggunaan.
Untuk mengetahui informasi mendetail tentang cara mengintegrasikan backend aplikasi dengan Cloud Marketplace, lihat Mengintegrasikan backend aplikasi.
Untuk contoh mengintegrasikan 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:
Menyediakan 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 dapat menggunakan ID akun ini untuk menautkan akun pengguna di produk Anda dengan Akun Google miliknya, 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.
Berintegrasi dengan Google API
Anda dapat mengintegrasikan aplikasi dengan Google API melalui menggunakan library klien, yang memberi Anda akses terprogram ke produk Google. Library klien tersedia untuk platform pengembangan 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 Anda, dan menangani pesan masuk.
Jika Anda memilih harga berdasarkan penggunaan, hubungkan 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 melakukan integrasi 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 discovery API. Dokumen penemuan untuk Partner Procurement API ada di URL ini:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Misalnya, jika Anda membuat library klien Python untuk
Partner Procurement API, gunakan
metode
build(). Untuk kode contoh yang membuat library klien, lihat
contoh codelab di GitHub.
Mengaktifkan Partner Procurement API di Konsol Google Cloud
Setelah Partner Engineer memberi Anda akses ke Partner Procurement API, Anda tidak perlu melakukan langkah tambahan untuk mengaktifkan API di Konsol Google Cloud.