Integrazione dell'app: configurazione

Questa sezione fornisce una panoramica dei passaggi per integrare la tua app con Google Cloud Marketplace. A livello generale, integra 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 Google 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 sull'abbonamento a un argomento Pub/Sub, consulta la Guida per gli abbonati Pub/Sub.

    • Esegui l'integrazione con l'API Partner Procurement per creare account per i clienti e collegarli con il loro acquisto su Google Cloud Marketplace. Devi inoltre utilizzare l'API Partner Procurement per aggiornare gli account collegati quando gli utenti modificano o annullano i propri piani di abbonamento.

    • Se hai scelto un modello di prezzi basato sull'utilizzo, esegui l'integrazione con il controllo del servizio per registrare le informazioni sull'utilizzo.

    Per informazioni dettagliate sull'integrazione del backend della tua app con Google Cloud Marketplace, consulta Integrazione del backend dell'app.

    Per un esempio di integrazione del backend di un prodotto di base con Google Cloud Marketplace e di una procedura dettagliata del codice di esempio, consulta il codelab per l'integrazione di un prodotto SaaS.

  • Integrazione del frontend

    Nel frontend della tua app devi configurare le seguenti integrazioni:

    • Crea una pagina di attivazione per i nuovi clienti che acquistano il tuo prodotto tramite Google Cloud Marketplace. Quando i nuovi clienti vengono indirizzati a questa pagina, Google invia anche un JSON Web Token (JWT), che contiene l'ID account dell'utente. Puoi utilizzare questo ID account per creare un nuovo account per l'utente e collegarlo al suo Account Google.

    • Integra il Single Sign-On (SSO) per consentire agli utenti di accedere alla tua app utilizzando i propri Account Google. Per integrare il servizio SSO, l'app deve verificare un JWT contenente l'ID account dell'utente. La tua app deve controllare l'ID account con l'account collegato dell'utente.

    Per informazioni dettagliate sull'integrazione del frontend della tua app con Google Cloud Marketplace, consulta Integrare il frontend della tua 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 l'app con le API di Google utilizzando le librerie client, che ti offrono accesso programmatico ai prodotti Google. Sono disponibili librerie client per le piattaforme di sviluppo più utilizzate, come Java, Python e .NET.

Installa le librerie client per la tua piattaforma dalla pagina Librerie client API.

Con le librerie client, puoi:

  • Connettiti al tuo abbonamento 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 sull'utilizzo a Google.

Per creare account collegati per i clienti e inviare e ricevere aggiornamenti sugli account utente, devi integrare anche 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 Google e crearne una nuova nel documento di rilevamento API. Il documento di individuazione per l'API Partner Procurement è disponibile 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, consulta gli esempi di codelab su GitHub.

Abilitazione dell'API Partner Procurement nella console

Producer Portal

Se usi Producer Portal, dopo che il tuo Partner Engineer ti ha concesso l'accesso all'API Partner Procurement, non sono necessari ulteriori passaggi per abilitare l'API nella console.

Portale partner

Se utilizzi il Portale partner, dopo che il tuo Partner Engineer ti ha concesso l'accesso all'API Partner Procurement per abilitare l'API nella console, vai al seguente URL:

https://console.cloud.google.com/apis/api/cloudcommerceprocurement.googleapis.com/overview?project=YOUR_PROJECT_ID

dove YOUR_PROJECT_ID è il progetto che ospita la tua soluzione, che hai creato quando configuri il tuo ambiente.