Questa sezione è 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 dell'app con i seguenti servizi e API di 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 sulla sottoscrizione a un argomento Pub/Sub, consulta la Guida per gli abbonati a Pub/Sub.
L'integrazione con l'API Partner Procurement per creare account per i clienti e per collegare questi account all'acquisto di Cloud Marketplace. Devi utilizzare l'API Partner Procurement anche per aggiornare gli account collegati quando gli utenti cambiano o annullano i propri piani di abbonamento.
Se hai scelto un modello di prezzi basato sull'utilizzo, esegui l'integrazione con Service Control per generare report sulle informazioni sull'utilizzo.
Per informazioni dettagliate sull'integrazione del backend dell'app con Cloud Marketplace, consulta Integrazione del 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 di frontend
Nel frontend della tua app, devi configurare le seguenti integrazioni:
Fornisci una pagina di registrazione per registrare account per i nuovi clienti che acquistano il tuo prodotto tramite Cloud Marketplace. Quando gli utenti visitano questa pagina, Google invia un token web JSON (JWT) contenente l'ID account dell'utente. Puoi utilizzare 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.
Facoltativamente, puoi scegliere di:
- Integra il Single Sign-On (SSO), in modo che i tuoi clienti possano accedere alla tua app utilizzando i loro Account Google. Se integri SSO, quando gli utenti accedono utilizzando SSO, Google invia un token web JSON (JWT) contenente informazioni sull'utente per consentirti di verificare.
Per informazioni dettagliate sull'integrazione del frontend dell'app con Cloud Marketplace, consulta Integrazione del frontend dell'app.
Prima di iniziare
- Verifica che il tuo Partner Engineer abbia abilitato l'accesso all'API Cloud Commerce Partner Procurement.
Integrazione con le API di Google
Puoi integrare la tua app con le API di Google utilizzando le librerie client, che offrono 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 prezzi basati sull'utilizzo, collegati all'API Service Control per segnalare a Google i dati sull'utilizzo.
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, è necessario installare le librerie client di Google e crearne una nuova dal documento di rilevamento API. Il documento di rilevamento dell'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 codice campione che crea una libreria client, consulta gli esempi di codelab su GitHub.
Abilita l'API Partner Procurement nella console Google Cloud
Una volta che il tuo Partner Engineer ti ha concesso l'accesso all'API Partner Procurement, non devi eseguire altri passaggi per abilitare l'API nella console Google Cloud.