Domande frequenti sull'API Google Wallet

Per iniziare

Che cos'è l'API Google Wallet?

L'API Google Wallet consente agli sviluppatori di creare tessere digitali in Google Wallet. L'API Google Wallet attualmente supporta carte d'imbarco, biglietti per eventi, carte fedeltà, offerte e pass di trasporto. Più di recente, è stato aggiunto un tipo di tessera generico per supportare casi d'uso aggiuntivi.

Come posso configurare il mio ambiente di sviluppo in base ai requisiti e alla complessità della mia attività?

Di seguito sono riportate guide che possono essere utilizzate per configurare un ambiente di sviluppo adatto a diversi livelli di complessità e sicurezza aziendale. L'utilizzo di più service account può consentire agli sviluppatori di creare un ambiente TEST separato dall'ambiente PROD.

Complessità della configurazione di base

1 account Business Console o 1 account principale Business Console a molti account emittente.

  • Questa opzione consente un approccio gestito centralmente utilizzando un account principale con da zero a più attività/emittenti secondarie.
  • 1 progetto Google Cloud.
  • 1 credenziale del service account.
  • Un unico insieme di utenti.

Complessità media della configurazione

1 account principale a molti account emittenti.

  • Questa opzione consente un approccio gestito centralmente utilizzando un account principale con molte attività secondarie.
  • 1 progetto Google Cloud.
  • Utenti della console aziendale distinti per emittente.
  • Credenziali di un account di servizio per molti.
    • 1 credenziale per attività/emittente.
    • Accesso con credenziali diverse per ogni attività.

Complessità della configurazione complessa

1 account principale a molti account emittenti.

  • Questa opzione consente un approccio gestito centralmente utilizzando un account principale con molte attività secondarie.
  • Da 1 a molti progetti Google Cloud.
  • Utenti della console aziendale distinti per emittente.
  • Credenziali di un account di servizio per molti.
    • 1 credenziale PROD per attività/emittente.
    • 1 credenziale DEV per attività/emittente.

Contatta l'assistenza

Utilizzare le tessere

Come faccio a eliminare classi o oggetti?

Al momento non puoi eliminare classi o oggetti da Google Wallet. Tuttavia, gli utenti possono scollegare gli oggetti da Google Wallet.

Come faccio a raggruppare più tessere?

L'utilizzo di GroupingID semplifica il raggruppamento delle tessere.

Come faccio ad aggiornare solo una parte di una tessera?

Segui la nostra guida al rendimento per capire come eseguire aggiornamenti parziali utilizzando le richieste PATCH.

Posso creare tessere in batch?

Segui la nostra guida al rendimento per capire come eseguire richieste batch utilizzando l'API.

Domande generali

Qual è il limite di frequenza per le richieste inviate all'API Google Wallet?

Le chiamate all'API Google Wallet sono limitate a 20 richieste al secondo.

L'API Google Wallet non ha un SLA ufficiale, ma consigliamo un timeout di 10 secondi, in base a una latenza del 99° percentile di circa 5 secondi. Tieni presente inoltre che la latenza dipende spesso da fattori esterni, ad esempio il tempo necessario per recuperare un'immagine ospitata su un server esterno quando inserisci un oggetto con quell'immagine, poiché dipende dalla latenza del server esterno.

Perché le immagini personali non possono essere incluse nelle tessere in Google Wallet?

Google Wallet non supporta le immagini personali sulle tessere perché le normative vigenti stabiliscono che tutti i consumatori hanno il diritto di disattivare la raccolta o il trattamento di dati sensibili. Se i dati sensibili (immagini personali) fanno parte dell'oggetto di valore (in un JWT), potrebbero sorgere problemi di hosting in cui i dati potrebbero diventare pubblici, il che non rientra nell'accordo di consenso originale. Per garantire la riservatezza dei dati, le immagini personali non sono consentite. Stiamo lavorando per supportare le immagini personali in futuro.

Quali codici di errore vengono restituiti dall'API Google Wallet?

Per un elenco dei codici di errore e delle eccezioni restituiti dall'API Google Wallet, consulta la sezione Codici di errore.

Come faccio ad attivare le notifiche push?

Al momento, le notifiche push create dagli sviluppatori non sono supportate da Google Wallet. Tuttavia, Google Wallet fornisce notifiche tempestive per le seguenti tessere. Al momento, le notifiche push create dagli sviluppatori non sono supportate da Google Wallet.

Verticale Notifica Attivata Documentazione
Evento Promemoria imminente 3 ore prima dell'evento documenti
Carta d'imbarco Promemoria imminente 3 ore prima della partenza del volo documenti
Carta d'imbarco Aggiornamento della tessera Modifica del terminal, del gate, dell'ora di imbarco o dell'ora di partenza di origine documenti
Scheda dell'offerta Promemoria relativo alla scadenza 48 ore prima della scadenza della scheda dell'offerta documenti
Generic Promemoria imminente 24 ore prima dell'inizio dell'intervallo di tempo documenti
Generic Promemoria relativo alla scadenza 48 ore prima della fine del "time internal" documenti

Gli ID commerciante possono essere eliminati?

Al momento, gli ID commerciante non possono essere eliminati o archiviati dalla console di Google Pay e Wallet.

Come faccio a utilizzare la funzionalità App Linking?

Applinking richiede l'inserimento nella lista consentita, che può essere richiesto qui.

Google Wallet supporta il geofencing?

Il geofencing non è attualmente supportato.

Come faccio a configurare un programma fedeltà?

Puoi configurare un programma fedeltà e di registrazione seguendo questa guida.

Come faccio a inviare a Google il mio logo per le tessere del trasporto pubblico?

Utilizza questo modulo per inviare a Google il logo da inserire nella lista consentita.

Come gestire correttamente i dati userProfile codificati in Base64?

Assicurati di utilizzare la codifica UTF-8 durante l'intero processo. La stringa JSON viene prima codificata in UTF-8 e successivamente codificata utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Ciò corrisponde alla sezione 4 dell'RFC 3548.

Come faccio a creare account emittente in modo programmatico?

Consulta questa guida per creare account emittente tramite l'API.

Smart Tap

Ho bisogno di un lettore NFC speciale per le tessere Google Smart Tap?

Deve essere un terminale compatibile con Smart Tap. Un elenco dei fornitori certificati è disponibile qui.

Come faccio a far funzionare le mie tessere con NFC?

Segui questa configurazione per consentire la riscossione della tessera con Smart Tap.

Token web JSON (JWT)

Esistono strumenti che semplificano l'implementazione e il debug dei JWT?

Sì, piattaforme come www.jwt.io ti consentono di decodificare ed eseguire il debug dei token durante il processo di sviluppo, permettendoti di verificare i contenuti che invii. Tieni presente che Google non ha alcuna affiliazione e non consiglia in modo specifico nessuna di queste terze parti.

Puoi creare in anticipo classi e oggetti utilizzando l'API prima di creare il link per salvare la tessera (JWT).

Risoluzione dei problemi

Perché l'impostazione dell'ora mostra l'ora sbagliata per l'evento?

L'ora visualizzata sulla tessera è l'ora locale dell'evento, con l'offset per l'ora in cui si svolge l'evento.

Il mio logo non viene visualizzato nelle tessere che ho creato. Quale potrebbe essere il problema?

  • Innanzitutto, assicurati che il logo rispetti le linee guida e sia salvato in formato PNG.
  • Assicurati che il logo sia facilmente disponibile con un'affidabilità elevata. Non reindirizzare a file immagine, in quanto potrebbero causare errori 404. Le immagini devono essere ospitate in una posizione HTTPS, altrimenti non saranno visibili in Google Wallet.
  • Assicurati che tutti i campi obbligatori contrassegnati come tali nell'API siano impostati nella tessera.

Assistenza e feedback

Come faccio a contattare l'assistenza tecnica?

Per ulteriore assistenza, contatta il team di assistenza facendo clic sul pulsante "Contatta l'assistenza" nella barra laterale sinistra della console Google Pay e Google Wallet.

Come faccio a lasciare un feedback sul prodotto?

Per lasciare un feedback sul prodotto, fai clic sul pulsante "Invia feedback" nel quadrante in alto a destra della pagina del sito per sviluppatori e seleziona "Feedback sul prodotto". Successivamente, descrivi il tuo feedback nell'area di testo e fai clic su "Invia".

Come faccio a lasciare un feedback sulla documentazione?

Per lasciare un feedback sulla documentazione, fai clic sul pulsante "Invia feedback" nel quadrante in alto a destra della pagina del sito per sviluppatori e seleziona "Feedback sulla documentazione". Dopodiché, descrivi il tuo feedback nell'area di testo e fai clic su "Invia".