Questa sezione fornisce una panoramica dei passaggi per integrare la tua app con Cloud Marketplace. A livello generale, puoi integrare la tua app con Google Cloud nei seguenti modi:
Integrazione del backend
Devi integrare il backend della tua app con le seguenti API di Google e servizi:
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 iscriverti 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 per creare account per i clienti e collegarli al loro acquisto su Cloud Marketplace. Devi anche utilizzare l'API Partner Procurement per aggiornare gli account collegati quando gli utenti modificano o annullano i loro 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 del codice campione, consulta il codelab per l'integrazione di un prodotto 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 servizio 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 Integrazione del frontend dell'app.
Se utilizzi App Lifecycle Manager per eseguire il deployment e gestire il tuo prodotto SaaS, puoi anche usufruire di una convalida semplificata e dell'onboarding dei tenant con un clic. Per maggiori informazioni, consulta Eseguire l'integrazione con App Lifecycle Manager.
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 .
Eseguire l'integrazione con le API di Google
Puoi integrare la tua app 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 un codice campione che crea una libreria client, vedi gli
esempi di codelab su GitHub.