Questa sezione offre 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:
Integra 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 abbonarti a un argomento Pub/Sub, consulta la Guida per gli abbonati a Pub/Sub.
Integra l'API Partner Procurement per creare account per i clienti e collegarli all'acquisto su Cloud Marketplace. Devi anche 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 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 registrare gli account dei nuovi clienti che acquistano il tuo prodotto tramite Cloud Marketplace. Quando gli utenti visitano questa pagina, Google invia un token JWT (JSON Web Token) contenente l'ID account dell'utente. Utilizza 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:
- Integrare il Single Sign-On (SSO) in modo che i clienti possano accedere alla tua app utilizzando i propri Account Google. Se integri il servizio SSO, quando gli utenti accedono utilizzando il servizio SSO, Google invia un token JWT (JSON Web Token) contenente informazioni sull'utente che devi verificare.
Per informazioni dettagliate sull'integrazione del frontend della tua app con Cloud Marketplace, consulta Integrare il frontend dell'app.
Se utilizzi App Lifecycle Manager per eseguire il deployment e gestire il tuo prodotto SaaS, puoi anche usufruire della convalida semplificata e dell'onboarding dei tenant con un clic. Per ulteriori informazioni, consulta Integrare App Lifecycle Manager.
Prima di iniziare
- Verifica che il tuo Partner Engineer abbia abilitato l'accesso all' API Partner Procurement di Cloud Commerce. Dopo che il tuo Partner Engineer ti ha concesso l'accesso a l'API Partner Procurement, non devi eseguire ulteriori passaggi per abilitare l'API nella Google Cloud console.
Integrare 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 la maggior parte delle 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:
- Connetterti alla sottoscrizione Pub/Sub e gestire i messaggi in entrata.
- 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 integrare 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 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 l'API Partner Procurement, utilizza il
build()
metodo. Per il codice campione che crea una libreria client, consulta gli
esempi di codelab su GitHub.