Per offrire un prodotto di agente di AI tramite Google Cloud Marketplace, devi integrare il tuo prodotto con Google Cloud. Questa integrazione tecnica prevede una serie di passaggi nel backend e nel frontend del tuo prodotto.
Prima di iniziare
- Verifica che il Partner Engineer abbia abilitato l'accesso all'API Cloud Commerce Partner Procurementt. Dopo che il Partner Engineer ti ha concesso l'accesso all'API Partner Procurement, non devi eseguire ulteriori passaggi per abilitare l'API nella console Google Cloud .
Integrazione del backend
Devi integrare il backend della tua app con le seguenti API e servizi Google:
Esegui l'integrazione con Pub/Sub per ricevere notifiche da Cloud Marketplace, ad esempio quando un utente si registra al tuo prodotto. Il tuo Partner Engineer crea un argomento Pub/Sub a cui devi abbonarti per ricevere le notifiche.
Per informazioni su come sottoscrivere un argomento Pub/Sub, consulta la Guida per i sottoscrittori Pub/Sub.
Integra l'API Partner Procurement. In questo modo potrai:
- Crea account per i clienti.
- Collega gli account dei clienti al loro acquisto su Cloud Marketplace.
- Aggiorna gli account collegati quando gli utenti modificano o annullano i propri piani di abbonamento.
Se hai scelto un modello di prezzi basato sull'utilizzo, esegui l'integrazione con Service Control per segnalare le informazioni sull'utilizzo.
Per informazioni dettagliate sull'integrazione del backend dell'app con Cloud Marketplace, vedi Configurare il backend dell'app.
Per un esempio di integrazione del backend di un prodotto di base con Cloud Marketplace e una procedura dettagliata delcodice campioneo, consulta il codelab per l'integrazione di un prodotto Software as a Service (SaaS).
Integrazione del frontend
Nel frontend della tua app, devi configurare le seguenti integrazioni:
Fornisci una pagina di registrazione per registrare gli account dei nuovi clienti che acquistano il tuo prodotto tramite Cloud Marketplace. Quando gli utenti visitano questa pagina, Google invia un JSON Web Token (JWT) contenente l'ID account dell'utente. Utilizzi questo ID account per collegare l'account dell'utente nel tuo prodotto al suo Account Google e anche per Identity and Access Management (IAM).
Fornisci una pagina di accesso per i tuoi clienti.
In via facoltativa, puoi scegliere di:
Integra il Single Sign-On (SSO), in modo che i tuoi clienti possano accedere alla tua app utilizzando i propri Account Google. Se integri SSO, quando gli utenti accedono utilizzando SSO, Google invia un token web JSON (JWT) contenente informazioni sull'utente da verificare.
Per informazioni dettagliate sull'integrazione del frontend dell'app con Cloud Marketplace, vedi Integrare il frontend dell'app.
Eseguire l'integrazione con le API di Google
Puoi integrare il tuo prodotto di agente AI con le API di Google utilizzando le librerie client, che ti consentono l'accesso programmatico ai prodotti Google. Le librerie client sono disponibili per le piattaforme di sviluppo più diffuse, come Java, Python e .NET.
Installa le librerie client per la tua piattaforma dalla pagina Librerie client API. Con le librerie client puoi:
- Connettiti alla tua sottoscrizione Pub/Sub e gestisci i messaggi in arrivo.
- Se hai scelto i prezzi basati sull'utilizzo, connettiti all'API Service Control per segnalare i dati di utilizzo a Google.
Per creare account collegati per i clienti e per inviare e ricevere aggiornamenti sugli account utente, devi anche eseguire l'integrazione con l'API Partner Procurement. Poiché l'API Partner Procurement è limitata, devi creare una nuova libreria client per l'API.
Per creare una nuova libreria client, devi installare le librerie client di Google e creare una nuova libreria dal documento di rilevamento dell'API. Il documento di rilevamento per l'API Partner Procurement si trova a questo URL:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Ad esempio, se stai creando una libreria client Python per l'API Partner Procurement, utilizza il metodo build(). Per il codice campione che crea una libreria client, vedi gli
esempi di codelab su GitHub.
Passaggi successivi
- Configura il backend della tua app.
- Integra il frontend dell'app.
- Pubblica il tuo agente di AI su Cloud Marketplace.