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 tessere per il trasporto pubblico. Più di recente è stato aggiunto un tipo di pass generico per supportare ulteriori casi d'uso.
Come posso configurare il mio ambiente di sviluppo in base ai requisiti e alla complessità della mia azienda?
Di seguito sono riportate delle guide che possono essere utilizzate per configurare un ambiente di sviluppo in grado di soddisfare diversi livelli di sicurezza e complessità aziendale. L'utilizzo di più account di servizio consente agli sviluppatori di creare un ambiente di TEST separato dal proprio ambiente PROD.
Complessità della configurazione di base
Un account Business Console o 1 account principale di Business Console per più account emittente.
- Questa opzione consente un approccio gestito centralmente utilizzando un account principale con zero o più società/emittente secondarie.
- 1 progetto Google Cloud.
- 1 credenziale dell'account di servizio.
- Un unico insieme di utenti.
Complessità di configurazione media
Un account principale per più conti emittente.
- Questa opzione consente un approccio gestito centralmente utilizzando un account principale con molte attività secondarie.
- 1 progetto Google Cloud.
- Utenti di Business Console distinti per emittente.
- da 1 a più account di servizio.
- 1 credenziale per attività/emittente.
- Accesso a credenziali diverse per azienda.
Complessità di configurazione complessa
Un account principale per più conti emittente.
- Questa opzione consente un approccio gestito centralmente utilizzando un account principale con molte attività secondarie.
- da uno a più progetti Google Cloud.
- Utenti di Business Console distinti per emittente.
- da 1 a più account di servizio.
- 1 credenziale PROD per azienda/emittente.
- 1 credenziale DEV per azienda/emittente.
Utilizzare i pass
Come si eliminano classi o oggetti?
Al momento non puoi eliminare corsi o oggetti da Google Wallet. Tuttavia, gli utenti possono scollegare gli oggetti dal loro Google Wallet.
Come faccio a raggruppare più tessere?
L'utilizzo di GroupingID semplifica il raggruppamento dei pass.
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 gruppo?
Segui la nostra guida alle prestazioni per capire come eseguire richieste batch utilizzando l'API.
Domande generali
Qual è il limite di frequenza per le richieste inviate all'API Google Wallet?
La frequenza delle chiamate all'API Google Wallet è limitata a 20 richieste al secondo.
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, vedi Codici di errore.Come si attivano le notifiche push?
Le notifiche push create dallo sviluppatore non sono attualmente supportate da Google Wallet. Tuttavia, Google Wallet fornisce notifiche tempestive per i seguenti pass. Le notifiche push create dallo sviluppatore non sono attualmente supportate da Google Wallet.
| Verticale | Notifica | Attivato | Documentazione |
|---|---|---|---|
| Evento | Promemoria imminente | 3 ore prima dell'evento | docs |
| Carta d'imbarco | Promemoria imminente | 3 ore prima della partenza del volo | docs |
| Carta d'imbarco | Aggiornamento della tessera | Modifica del terminal di partenza, del gate, dell'orario di imbarco o di partenza | docs |
| Scheda dell'offerta | Promemoria scadenza | 48 ore prima della scadenza della scheda dell'offerta | docs |
| Generico | Promemoria imminente | 24 ore prima dell'inizio dell'"intervallo di tempo" | docs |
| Generico | Promemoria scadenza | 48 ore prima del termine "orario per uso interno" | docs |
È possibile eliminare gli ID commerciante?
Al momento, gli ID commerciante non possono essere eliminati o archiviati dalla console Google Pay & Wallet.
Come si utilizza la funzionalità Applinking?
L'applinking richiede l'inserimento nella lista consentita, che può essere richiesta qui.
Google Wallet supporta il geofencing?
Il geofencing non è attualmente supportato.
Come si configura un programma fedeltà?
Per configurare un programma di registrazione e fedeltà, segui questa guida.
Come faccio a inviare a Google il mio logo per i pass per il trasporto pubblico?
Utilizza questo modulo per inviare a Google il logo da inserire nella lista consentita.
Come gestire correttamente i dati del profilo utente codificati in Base64?
Assicurati di utilizzare la codifica UTF-8 durante tutta la procedura. La stringa JSON viene prima codificata in UTF-8 e successivamente codificata utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Corrisponde alla sezione 4 di RFC 3548.
Come faccio a creare account emittente a livello di programmazione?
Consulta questa guida per creare conti emittente tramite l'API.
Smart tap
Mi serve un lettore NFC speciale per i pass Google SmartTap?
Deve essere un terminale che supporti SmartTap. Un elenco dei fornitori certificati è disponibile qui.
Come faccio a far funzionare le mie tessere con la tecnologia NFC?
Segui questa configurazione per consentire al tuo pass di essere utilizzato con Smart Tap.
Token web JSON (JWT)
Esistono strumenti che semplificano l'implementazione e il debug dei JWT?
Sì, le piattaforme come www.jwt.io ti consentono di decodificare ed eseguire il debug dei tuoi token durante il processo di sviluppo, consentendoti di verificare i contenuti che stai inviando. Tieni presente che Google non ha affiliazione e non consiglia specificatamente queste terze parti.
L'URL del mio link JWT supera la limitazione del browser di 1800 caratteri. Che cosa devo fare?
Puoi precreare classi e oggetti utilizzando l'API prima di creare il link JWT (Save Pass Link).
Risoluzione dei problemi
Perché la mia impostazione dell'ora mostra l'ora errata per l'evento?
L'ora visualizzata sulla tessera è l'ora locale dell'evento, con un offset dell'ora in cui si trova l'evento.
Il mio logo non verrà visualizzato nei pass che ho creato. Quale potrebbe essere il problema?
- Innanzitutto, assicurati che il tuo logo rispetti le linee guida e che sia salvato in formato PNG.
- Assicurati che il logo sia facilmente disponibile e con un'elevata affidabilità. Non reindirizzare a file immagine che possono causare errori 404. Le immagini devono essere ospitate sulla posizione HTTPS, altrimenti non saranno visibili in Google Wallet.
- Assicurati che tutti i campi obbligatori contrassegnati come obbligatori nell'API siano impostati nel pass.
Assistenza e feedback
Come posso contattare l'assistenza tecnica?
Per ulteriore supporto, contatta il team di assistenza facendo clic sul pulsante "Contatta l'assistenza" nella barra laterale sinistra della console Google Pay e Wallet.
Come faccio a lasciare un feedback sul prodotto?
Per lasciare un feedback sul prodotto, fai clic sul pulsante "Invia feedback" nel riquadro in alto a destra della pagina del sito per sviluppatori e seleziona "Feedback sul prodotto". Poi, 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". Poi, descrivi il tuo feedback nell'area di testo e fai clic su "Invia".