KI‑Agent in Google Cloud Marketplace einbinden

Wenn Sie ein KI-Agent-Produkt über Google Cloud Marketplace anbieten möchten, müssen Sie Ihr Produkt in Google Cloudeinbinden. Diese technische Integration umfasst eine Reihe von Schritten im Backend und Frontend Ihres Produkts.

Hinweise

  • Achten Sie darauf, dass Ihr Partnerentwickler den Zugriff auf die Cloud Commerce Partner Procurement API aktiviert hat. Nachdem Ihr Partnerentwickler Ihnen Zugriff auf die Partner Procurement API gewährt hat, müssen Sie keine weiteren Schritte ausführen, um die API in der Google Cloud -Konsole zu aktivieren.

Backend-Integration

Sie müssen das Backend Ihrer Anwendung in die folgenden Google APIs und -Dienste einbinden:

  • In Pub/Sub, um Benachrichtigungen von Cloud Marketplace zu erhalten, z. B. wenn sich ein Nutzer für Ihr Produkt anmeldet. Ihr Partnerentwickler erstellt ein Pub/Sub-Thema, das Sie für Benachrichtigungen abonnieren müssen.

    Informationen zum Abonnieren eines Pub/Sub-Themas finden Sie im Pub/Sub-Abonnentenhandbuch.

  • Einbindung in die Partner Procurement API Damit haben Sie folgende Möglichkeiten:

    • Konten für Kunden erstellen
    • Verknüpfen Sie die Konten der Kunden mit ihren Cloud Marketplace-Käufen.
    • Aktualisieren Sie die verknüpften Konten, wenn Nutzer ihre Abos ändern oder kündigen.
  • Wenn Sie ein nutzungsabhängiges Preismodell ausgewählt haben, binden Sie es in Service Control ein, um Nutzungsinformationen zu melden.

    Ausführliche Informationen zum Einbinden des Back-Ends Ihrer Anwendung in Cloud Marketplace finden Sie unter Back-End Ihrer Anwendung konfigurieren.

    Ein Beispiel für die Integration des Back-Ends eines Basisprodukts in Cloud Marketplace und eine Erläuterung des Beispielcodes finden Sie im Codelab zum Integrieren eines SaaS-Produkts (Software as a Service).

Frontend-Integration

Das Frontend Ihrer Anwendung muss so eingebunden werden:

  • Stellen Sie eine Registrierungsseite für neue Kunden bereit, die Ihr Produkt über Cloud Marketplace kaufen. Wenn Nutzer diese Seite aufrufen, sendet Google ein JSON Web Token (JWT), das die Konto-ID des Nutzers enthält. Sie verwenden diese Konto-ID, um das Konto des Nutzers in Ihrem Produkt mit seinem Google-Konto zu verknüpfen und für Identity and Access Management (IAM).

  • Stellen Sie eine Anmeldeseite für Ihre Kunden bereit.

Optional können Sie Folgendes tun:

  • Binden Sie die Einmalanmeldung (SSO) ein, damit sich Ihre Kunden über ihre Google-Konten bei Ihrer App anmelden können. Wenn Sie SSO einbinden und sich Nutzer über SSO anmelden, sendet Google ein JSON-Web-Token (JWT) mit Informationen über den Nutzer, die Sie überprüfen können.

    Ausführliche Informationen zum Einbinden des Front-Ends Ihrer Anwendung in Cloud Marketplace finden Sie unter Front-End Ihrer Anwendung einbinden.

In Google APIs einbinden

Sie können Ihr KI-Agent-Produkt in Google APIs einbinden, indem Sie Clientbibliotheken verwenden, mit denen Sie programmgesteuert auf Google-Produkte zugreifen können. Die Clientbibliotheken stehen für die gängigsten Entwicklungsplattformen wie Java, Python und .NET zur Verfügung.

Installieren Sie die Clientbibliotheken für Ihre Plattform auf der Seite mit den API-Clientbibliotheken. Mit den Clientbibliotheken können Sie:

  • Stellen Sie eine Verbindung zu Ihrem Pub/Sub-Abo her und verarbeiten Sie eingehende Nachrichten.
  • Eine Verbindung zur Service Control API herstellen, um Nutzungsdaten an Google zu melden, wenn Sie eine nutzungsbasierte Preisgestaltung gewählt haben.

Sie brauchen auch die Partner Procurement API, um verknüpfte Konten für Kunden zu erstellen und Aktualisierungen von Nutzerkonten zu senden und zu empfangen. Da die Partner Procurement API eingeschränkt ist, müssen Sie eine neue Clientbibliothek für die API erstellen.

Für die Erstellung der neuen Clientbibliothek installieren Sie zuerst die Google-Clientbibliotheken und erstellen dann eine neue Bibliothek aus dem Discovery-Dokument der API. Das Discovery-Dokument für die Partner Procurement API befindet sich unter dieser URL:

https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1

Wenn Sie beispielsweise eine Python-Clientbibliothek für die Partner Procurement API erstellen, verwenden Sie die Methode build(). Beispielcode zum Erstellen einer Clientbibliothek finden Sie in den Codelab-Beispielen auf GitHub.

Nächste Schritte