Google Wallet offre un'API REST che ti consente di creare e gestire le tessere inviando richieste all'API Google Wallet tramite HTTP. Ciò è utile per chi vuole creare servizi lato server che funzionino con le tessere in modo programmatico.
Per utilizzare l'API REST di Google Wallet, devi abilitare l'API nella console Google Cloud, creare un account di servizio Google Cloud, quindi generare una chiave per l'account di servizio.
Quando crei tessere con l'API REST, la chiave dell'account di servizio utilizzata per firmare i tuoi passe oggetti codificati con token web JSON.
Per altre operazioni, come l'aggiornamento o l'eliminazione delle tessere, la chiave dell'account di servizio viene inviata con la richiesta per autenticarti come emittente della tessera.
1. Abilita l'API REST di Google Wallet
Per abilitare l'API REST di Google Wallet, segui questi passaggi:
- Se non hai ancora un account Google Cloud, vai alla console Google Cloud e segui i passaggi per registrare un nuovo account.
- Dal menu a discesa del progetto nella parte superiore della console, seleziona il progetto Google Cloud che vuoi utilizzare o creane uno nuovo.
- Vai alla pagina dei dettagli del prodotto API Google Wallet nel Marketplace della console Google Cloud.
- Fai clic sul pulsante "Attiva". Tra pochi istanti, l'API REST di Google Wallet sarà disponibile per il progetto Google Cloud selezionato.
2. Genera una chiave dell'account di servizio Google Cloud
Per autenticare le richieste all'API REST di Google Wallet, devi creare un account di servizio e generare una chiave dell'account di servizio seguendo questi passaggi:
- Vai alla pagina "Crea account di servizio" nella console Google Cloud.
- Inserisci i dettagli dell'account di servizio. Prendi nota dell'indirizzo email dell'account di servizio che appare sotto il campo "ID account di servizio". Ne avrai bisogno in seguito quando utilizzerai l'account di servizio per autenticare le tue richieste all'API REST di Google Wallet.
- Fai clic sul pulsante "FINE". Non è necessario completare gli altri passaggi di creazione dell'account di servizio.
- Fai clic sulla voce di menu "CHIAVE" nella parte superiore della pagina.
- Fai clic sul menu a discesa "AGGIUNGI CHIAVE", quindi su "Crea nuova chiave".
- Seleziona il tipo di chiave "JSON".
- Fai clic su "CREA" per creare e scaricare la chiave dell'account di servizio.
3. Autorizza il tuo account di servizio nella console Google Wallet
Per autenticare le tue richieste all'API REST di Google Wallet utilizzando una chiave dell'account di servizio, devi aggiungere l'indirizzo email del tuo account di servizio come utente al tuo account emittente. Per aggiungere il tuo account di servizio come utente:
- Vai alla pagina "Account di servizio" nella console Google Cloud.
- Copia l'indirizzo email dell'account di servizio che vuoi utilizzare per autenticare le tue richieste all'API Google Wallet.
- Vai alla console Google Pay & Wallet.
- Nel menu di navigazione a sinistra, fai clic su "Utenti".
- Fai clic su "Invita un utente".
- Inserisci l'indirizzo email del tuo account di servizio.
- Nel menu a discesa "Livello di accesso", seleziona "Sviluppatore".
- Fai clic sul pulsante "Invita".
Dopo aver aggiunto l'account di servizio, puoi utilizzare qualsiasi chiave dell'account di servizio generata per autenticare le richieste all'API REST di Google Wallet. Se utilizzi le chiavi degli account di servizio, tieni presente che si tratta di credenziali altamente sensibili che devono essere utilizzate solo in ambienti sicuri lato server.