Mengintegrasikan aplikasi dengan Google Cloud Marketplace
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Bagian ini adalah ringkasan langkah-langkah untuk mengintegrasikan aplikasi Anda dengan Cloud Marketplace. Pada tingkat tinggi, Anda mengintegrasikan aplikasi dengan
Google Cloud dengan cara berikut:
Integrasi backend
Anda harus mengintegrasikan backend aplikasi dengan 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.
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.
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, 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 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:
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-02 UTC."],[],[],null,["# Integrate your app with Google Cloud Marketplace\n\nThis section is an overview of the steps to integrate your app with\nCloud Marketplace. At a high level, you integrate your app with\nGoogle Cloud in the following ways:\n\n- **Backend integration**\n\n You must integrate your app's backend with the following Google APIs and\n services:\n - Integrate with Pub/Sub to receive notifications from\n Cloud Marketplace, such as when a user signs up for your product.\n Your Partner Engineer creates a Pub/Sub topic that you\n must subscribe to for notifications.\n\n For information on subscribing to a Pub/Sub topic, see\n the [Pub/Sub Subscriber Guide](/pubsub/docs/subscriber).\n - Integrate with the Partner Procurement API to create accounts for\n customers, and to link these accounts with their Cloud Marketplace\n purchase. You must also use the Partner Procurement API to update the\n linked accounts when users change or cancel their subscription plans.\n\n - If you've chosen a usage-based pricing model, integrate with\n Service Control to report usage information.\n\n For detailed information on integrating your app's backend with\n Cloud Marketplace, see\n [Configure your app's backend](/marketplace/docs/partners/integrated-saas/backend-integration).\n\n For an example of integrating the backend of a basic product with\n Cloud Marketplace and a walkthrough of the sample code, see the\n [codelab for integrating a SaaS product](https://codelabs.developers.google.com/codelabs/gcp-marketplace-integrated-saas/#0).\n- **Frontend integration**\n\n In your app's frontend, you must set up the following integrations:\n - Provide a sign up page to sign up accounts for new customers who buy your\n product through Cloud Marketplace. When users visit this page, Google\n sends a\n [JSON Web Token (JWT)](https://jwt.io/introduction/)\n containing the user's account ID. You use this account ID to link the\n user's account in your product with their Google account, and also for\n Identity and Access Management (IAM).\n\n | **Note:** It's possible for a single user to have multiple Google Cloud account IDs, or for multiple users to share a common Google Cloud account ID, depending on how they or their organization have configured their usage of Google Cloud.\n - Provide a login page for your customers.\n\n Optionally, you can choose to:\n - Integrate single sign-on (SSO), so that your customers can sign into your app using their Google accounts. If you integrate SSO, when users sign in by using SSO, Google sends a [JSON Web Token (JWT)](https://jwt.io/introduction/) containing information about the user for you to verify.\n\n For detailed information on integrating your app's frontend with\n Cloud Marketplace, see\n [Integrating your app's frontend](/marketplace/docs/partners/integrated-saas/frontend-integration).\n\nBefore you begin\n----------------\n\n- Verify that your Partner Engineer has enabled access to the Cloud Commerce Partner Procurement API. After your Partner Engineer has granted you access to the Partner Procurement API, you don't need to take any additional steps to enable the API in Google Cloud console.\n\nIntegrate with Google APIs\n--------------------------\n\nYou can integrate your app with Google APIs by\n[using client libraries](/apis/docs/client-libraries-explained), which give you\nprogrammatic access to Google products. The client libraries are available for\nmost popular development platforms, such as Java, Python, and .NET.\n\nInstall the client libraries for your platform from the\n[API Client Libraries page](https://developers.google.com/api-client-library/).\nWith the client libraries, you can:\n\n- Connect to your Pub/Sub subscription, and handle incoming messages.\n- If you chose usage-based pricing, connect to the Service Control API to report usage data to Google.\n\nTo create linked accounts for customers, and to send and receive updates about\nuser accounts, you must also integrate with the Partner Procurement API.\nBecause the Partner Procurement API is restricted, you must build a\nnew client library for the API.\n\nTo build a new client library, you must install the Google client libraries,\nand build a new library from the API discovery document. The discovery document\nfor the Partner Procurement API is at this URL: \n\n https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1\n\nFor example, if you're building a Python client library for the\nPartner Procurement API, use the\n[`build()`](https://googleapis.github.io/google-api-python-client/docs/epy/googleapiclient.discovery-module.html#build)\nmethod. For sample code that builds a client library, see the\n[codelab samples on GitHub](https://github.com/googlecodelabs/gcp-marketplace-integrated-saas/blob/master/python3/impl/step_2_account/app.py#L39)."]]
