Questa sezione fornisce una panoramica della procedura per integrare la tua app con Cloud Marketplace. A livello generale, integri la tua app con Google Cloud nei seguenti modi:
Integrazione del backend
Devi integrare il backend dell'app con le seguenti API di Google e Google Cloud:
Eseguire l'integrazione con Pub/Sub per ricevere notifiche da Cloud Marketplace, ad esempio quando un utente si registra a un prodotto. Il tuo Partner Engineer crea un argomento Pub/Sub che deve iscriversi per ricevere notifiche.
Per informazioni su come iscriversi a un argomento Pub/Sub, consulta la Guida per i sottoscrittori a Pub/Sub.
Eseguire l'integrazione con l'API Partner Procurement per creare account per clienti e di collegare questi account a Cloud Marketplace acquisto. Devi inoltre utilizzare l'API Partner Procurement per aggiornare gli account collegati quando gli utenti modificano o annullano i piani di abbonamento.
Se hai scelto un modello di prezzi basato sull'utilizzo, integra Service Control per segnalare le informazioni sull'utilizzo.
Per informazioni dettagliate sull'integrazione del backend della tua app con Cloud Marketplace, consulta Configura 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 di esempio, consulta il codelab per l'integrazione di un prodotto SaaS.
Integrazione del frontend
Nel frontend dell'app, devi configurare le seguenti integrazioni:
Fornisci una pagina di registrazione per creare account per i nuovi clienti che acquistano il tuo prodotto tramite Cloud Marketplace. Quando gli utenti visitano questa pagina, Google invia un JWT (JSON Web Token) contenente l'ID account dell'utente. Utilizza questo ID account per collegare l'account utente nel tuo prodotto con il suo Account Google, nonché per Identity and Access Management (IAM).
Fornisci una pagina di accesso per i tuoi clienti.
Se vuoi, puoi scegliere di:
- Integrare il servizio Single Sign-On (SSO), in modo che i clienti possano accedere all'account 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 della tua app con Cloud Marketplace, consulta Integrazione del frontend dell'app.
Prima di iniziare
- Verifica che il tuo Partner Engineer abbia abilitato l'accesso ai l'API Cloud Commerce Partner Procurement. Dopo che l'ingegnere partner ti ha concesso l'accesso all'API Partner Procurement, non devi eseguire altri passaggi per attivarla nella console Google Cloud.
Integrazione con le API di Google
Puoi integrare la tua app con le API di Google utilizzando librerie client, che ti offrono l'accesso programmatico ai prodotti Google. Le librerie client sono disponibili piattaforme di sviluppo più note, come Java, Python e .NET.
Installa le librerie client per la tua piattaforma dal Pagina Librerie client API. Con le librerie client puoi:
- Collegarti alla tua sottoscrizione Pub/Sub e gestire 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 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 delle API. Il documento di rilevamento per l'API Partner Procurement è disponibile al seguente URL:
https://cloudcommerceprocurement.googleapis.com/$discovery/rest?version=v1
Ad esempio, se stai creando una libreria client Python per il
API Partner Procurement, utilizza
build()
. Per il codice di esempio che crea una libreria client, consulta i
campioni di codelab su GitHub.