Google Cloud Marketplace で AI エージェント プロダクトを提供するには、プロダクトを Google Cloudと統合する必要があります。
始める前に
- パートナー エンジニアが Cloud Commerce Partner Procurement API へのアクセスを有効にしていることを確認します。 パートナー エンジニアが Partner Procurement API へのアクセス権限を付与した後、 Google Cloud コンソールで API を有効にするために追加の手順を行う必要はありません。
バックエンドの統合
アプリのバックエンドは、次の Google API およびサービスと統合する必要があります。
Pub/Sub と統合して、ユーザーがプロダクトを登録したときなどに Cloud Marketplace からの通知を受信します。通知を受けるためにサブスクライブする必要がある Pub/Sub トピックは、パートナー エンジニアが作成します。
Pub/Sub トピックのサブスクライブについては、Pub/Sub サブスクライバー ガイドをご覧ください。
Partner Procurement API と統合します。これにより、次のことが可能になります。
- お客様のアカウントを作成します。
- 顧客のアカウントを Cloud Marketplace の購入とリンクします。
- ユーザーがサブスクリプション プランを変更またはキャンセルした場合は、リンクされたアカウントを更新します。
従量制料金モデルを選択した場合は、Service Control と統合して使用状況情報を報告します。
アプリのバックエンドと Cloud Marketplace の統合の詳細については、アプリのバックエンドの構成をご覧ください。
基本プロダクトのバックエンドを Cloud Marketplace と統合する例およびサンプルコードのチュートリアルについては、Software as a Service（SaaS）プロダクトを統合するための Codelab をご覧ください。
Google API と統合する
クライアント ライブラリを使用して、AI エージェント プロダクトを Google API と統合できます。これにより、Google プロダクトにプログラムからアクセスできます。クライアント ライブラリは、Java、Python、.NET などの一般的な開発プラットフォームで利用できます。
API のクライアント ライブラリ ページから、お使いのプラットフォーム用のクライアント ライブラリをインストールします。 クライアント ライブラリを使用して、以下のことができます。
- Pub/Sub サブスクリプションに接続し、受信メッセージを処理します。
- 従量制料金を選択した場合は、Service Control API に接続して、使用状況データを Google に報告します。
顧客用のリンクされたアカウントを作成し、ユーザー アカウントに関する更新を送受信するには、Partner Procurement API とも統合する必要があります。Partner Procurement API は制限されているため、この API 用の新しいクライアント ライブラリを構築する必要があります。
新しいクライアント ライブラリを構築するには、Google クライアント ライブラリをインストールし、API ディスカバリ ドキュメントから新しいライブラリを構築する必要があります。Partner Procurement API のディスカバリ ドキュメントは、次の URL にあります。
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
たとえば、Partner Procurement API の Python クライアント ライブラリを構築している場合は、build() メソッドを使用します。クライアント ライブラリを構築するサンプルコードについては、GitHub の codelab サンプルをご覧ください。
次のステップ
- アプリのバックエンドを構成します。
- Cloud Marketplace に AI エージェントを公開します。