Questa sezione fornisce una panoramica della procedura per integrare la tua app con Cloud Marketplace. A grandi linee, puoi integrare la tua app con Google Cloud nei seguenti modi:
Integrazione del backend
Devi integrare il backend della tua 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. L'ingegnere partner crea un argomento Pub/Sub a cui devi abbonarti per le notifiche.
Per informazioni su come iscriverti a un argomento Pub/Sub, consulta la Guida per i sottoscrittori Pub/Sub.
Esegui l'integrazione con l'API Partner Procurement per creare account per i clienti e collegarli al loro acquisto nel marketplace Cloud. 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, consulta 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 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 token web JSON (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.
Se vuoi, puoi scegliere di:
- Integra il servizio Single Sign-On (SSO) in modo che i 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, consulta Integrare il frontend dell'app.
Prima di iniziare
- Verifica che l'Partner Engineer abbia attivato l'accesso all'API Cloud Commerce Partner Procurement. Dopo che l'Partner Engineer ti ha concesso l'accesso all'API Partner Procurement, non devi eseguire altri passaggi per attivarla 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 di accedere in modo 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:
- 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 a Google i dati di 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, 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 all'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, consulta i
campioni di codelab su GitHub.