Untuk menawarkan produk agen AI melalui Google Cloud Marketplace, Anda harus mengintegrasikan produk Anda dengan Google Cloud. Integrasi teknis ini melibatkan sejumlah langkah di backend dan frontend produk Anda.
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 untuk mengaktifkan API di konsol Google Cloud .
Integrasi backend
Anda harus mengintegrasikan backend aplikasi dengan API dan layanan Google berikut:
Lakukan integrasi 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 mendapatkan notifikasi.
Untuk mengetahui informasi tentang cara berlangganan topik Pub/Sub, lihat Panduan Pelanggan Pub/Sub.
Lakukan integrasi dengan Partner Procurement API. Hal ini memungkinkan Anda melakukan hal berikut:
- Buat akun untuk pelanggan.
- Tautkan akun pelanggan dengan pembelian Cloud Marketplace mereka.
- Perbarui akun tertaut saat pengguna mengubah atau membatalkan paket langganan mereka.
Jika Anda telah memilih model harga berbasis penggunaan, lakukan integrasi dengan Service Control untuk melaporkan informasi penggunaan.
Untuk mengetahui informasi mendetail tentang mengintegrasikan backend aplikasi Anda dengan Cloud Marketplace, lihat Mengonfigurasi backend aplikasi Anda.
Untuk contoh mengintegrasikan backend produk dasar dengan Cloud Marketplace dan panduan kode contoh, lihat codelab untuk mengintegrasikan produk software as a service (SaaS).
Integrasi frontend
Di frontend aplikasi, Anda harus menyiapkan integrasi berikut:
Sediakan halaman pendaftaran untuk mendaftarkan akun pelanggan baru yang membeli produk Anda melalui Cloud Marketplace. Saat pengguna membuka halaman ini, Google akan mengirim JSON Web Token (JWT) yang berisi ID akun pengguna. Anda menggunakan ID akun ini untuk menautkan akun pengguna di produk Anda dengan Akun Google-nya, dan juga untuk Identity and Access Management (IAM).
Menyediakan halaman login untuk pelanggan Anda.
Secara opsional, Anda dapat memilih untuk:
Integrasikan single sign-on (SSO), sehingga pelanggan Anda dapat login ke aplikasi Anda menggunakan Akun Google mereka. Jika Anda mengintegrasikan SSO, saat pengguna login menggunakan SSO, Google akan mengirimkan JSON Web Token (JWT) yang berisi informasi tentang pengguna untuk Anda verifikasi.
Untuk mengetahui informasi mendetail tentang mengintegrasikan frontend aplikasi Anda dengan Cloud Marketplace, lihat Mengintegrasikan frontend aplikasi Anda.
Berintegrasi dengan Google API
Anda dapat mengintegrasikan produk agen AI 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:
- Hubungkan ke langganan Pub/Sub Anda, dan tangani 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 info terbaru tentang akun pengguna, Anda juga harus berintegrasi dengan Partner Procurement API. Karena Partner Procurement API dibatasi, Anda harus membuat library klien baru untuk API tersebut.
Untuk membuat library klien baru, Anda harus menginstal library klien Google, dan membuat 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 membuat library klien Python untuk Partner Procurement API, gunakan metode build(). Untuk contoh kode yang membangun library klien, lihat
contoh codelab di GitHub.
Langkah berikutnya
- Konfigurasi backend aplikasi Anda.
- Integrasikan frontend aplikasi Anda.
- Publikasikan agen AI Anda ke Cloud Marketplace.