Bagian ini adalah ringkasan langkah-langkah untuk mengintegrasikan aplikasi Anda dengan Cloud Marketplace. Secara umum, Anda mengintegrasikan aplikasi dengan Google Cloud dengan cara berikut:
Integrasi backend
Anda harus mengintegrasikan backend aplikasi dengan Google API dan layanan berikut:
Integrasikan dengan Pub/Sub untuk menerima notifikasi dari Cloud Marketplace, seperti saat pengguna mendaftar ke produk Anda. Partner Engineer Anda membuat topik Pub/Sub yang harus Anda langgani untuk menerima notifikasi.
Untuk mengetahui informasi tentang cara 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 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 mengetahui contoh cara 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:
Sediakan 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:
- Mengintegrasikan 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 mengetahui informasi mendetail tentang cara mengintegrasikan frontend aplikasi dengan Cloud Marketplace, lihat Mengintegrasikan frontend aplikasi.
Jika Anda menggunakan App Lifecycle Manager untuk men-deploy dan mengoperasikan produk SaaS, Anda juga dapat memanfaatkan validasi yang disederhanakan dan orientasi tenant sekali klik. Untuk mengetahui informasi selengkapnya, lihat Mengintegrasikan dengan App Lifecycle Manager.
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 Google Cloud konsol.
Mengintegrasikan 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 paling populer, seperti Java, Python, dan .NET.
Instal library klien untuk platform Anda dari halaman Library Klien API. Dengan library klien, Anda dapat:
- Terhubung ke langganan Pub/Sub Anda, dan menangani pesan masuk.
- Jika Anda memilih harga berbasis penggunaan, hubungkan ke Service Control API untuk melaporkan data penggunaan ke Google.
Untuk membuat akun tertaut bagi pelanggan, serta mengirim dan menerima pembaruan tentang akun pengguna, Anda juga harus mengintegrasikan dengan Partner Procurement API. Karena Partner Procurement API dibatasi, Anda harus membuat library klien baru untuk API.
Untuk membuat library klien baru, Anda harus menginstal library klien Google, dan membuat 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
build()
metode. Untuk mengetahui kode contoh yang membuat library klien, lihat contoh codelab di GitHub
.