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 di eventi, carte fedeltà, offerte e tessere di trasporto pubblico. Di recente, è stato aggiunto un tipo di tessera generica per supportare altri casi d'uso.
Come faccio a configurare il mio ambiente di sviluppo in base alle esigenze e alla complessità della mia attività?
Di seguito sono riportate le guide che possono essere utilizzate per configurare un ambiente di sviluppo adatto a diversi livelli di complessità e sicurezza aziendale. L'utilizzo di più account di servizio consente agli sviluppatori di creare un ambiente TEST separato dal proprio ambiente PROD.
Complessità di configurazione di base
1 account Business Console o 1 account principale Business Console a molti account emittenti.
- Questa opzione consente un approccio gestito centralmente utilizzando un account principale con zero o più attività/emittenti secondari.
- 1 progetto Google Cloud.
- 1 credenziale dell'account di servizio.
- Un unico insieme di utenti.
Complessità di configurazione media
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 distinti della console aziendale per emittente.
- 1 a molte credenziali dell'account di servizio.
- 1 credenziale per attività/emittente.
- Accesso alle credenziali diverso per ogni attività.
Complessità di configurazione complessa
1 account principale a molti account emittenti.
- Questa opzione consente un approccio gestito centralmente utilizzando un account principale con molte attività secondarie.
- 1 a molti progetti Google Cloud.
- Utenti di Business Console distinti per emittente.
- 1 a molte credenziali dell'account di servizio.
- 1 credenziale PROD per attività/emittente.
- 1 credenziale DEV per attività/emittente.
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 dal proprio account Google Wallet.
Come faccio a raggruppare più tessere?
L'utilizzo di GroupingID semplifica il raggruppamento delle tessere.
Come si aggiorna solo una parte di una tessera?
Segui la nostra guida sul rendimento per scoprire come eseguire aggiornamenti parziali utilizzando le richieste PATCH.
Posso creare tessere in blocco?
Segui la nostra guida sul rendimento per capire come eseguire richieste collettive 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.
Perché le immagini personali non sono consentite sulle 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 l'elaborazione di dati sensibili. Poiché i dati sensibili (immagini personali) fanno parte dell'oggetto di valore (in un JWT), potrebbero verificarsi problemi di hosting in cui i dati potrebbero diventare pubblici al di fuori del contratto di consenso originale. Per garantire la riservatezza dei dati, non sono consentite immagini personali. Ci stiamo adoperando 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 Codici di errore.Come faccio ad attivare le notifiche push?
Al momento, Google Wallet non supporta le notifiche push create dagli sviluppatori. Tuttavia, Google Wallet fornisce notifiche tempestive per le seguenti tessere. Le notifiche push create dagli sviluppatori non sono attualmente supportate da Google Wallet.
| Verticale | Notifica | Attivato | 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 tessera | Modifica del terminal di partenza, del gate, dell'orario di imbarco o di partenza | 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à di collegamento delle app?
L'applinking richiede l'inserimento nella lista consentita, che può essere richiesto qui.
Google Wallet supporta il geofencing?
Il geofencing non è al momento supportato.
Come faccio a configurare un programma fedeltà?
Per configurare un programma di registrazione e fedeltà, segui questa guida.
Come faccio a inviare a Google il mio logo per le tessere per i trasporti pubblici?
Utilizza questo modulo per inviare a Google il logo da inserire nella lista consentita.
Come gestire correttamente i dati di userProfile codificati in base64?
Assicurati di utilizzare la codifica UTF-8 durante l'elaborazione. La stringa JSON viene prima codificata in UTF-8 e successivamente utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Ciò corrisponde alla sezione 4 RFC 3548.
Come faccio a creare account emittente in modo programmatico?
Consulta questa guida per creare account emittenti tramite l'API.
Smart Tap
Ho bisogno di un lettore NFC speciale per le tessere Google SmartTap?
Deve essere un terminale compatibile con SmartTap. Qui puoi trovare un elenco di fornitori certificati.
Come faccio a far funzionare le mie tessere con NFC?
Segui questa configurazione per abilitare la possibilità di utilizzare la 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 e eseguire il debug dei token durante il processo di sviluppo, in modo da verificare i contenuti inviati. Tieni presente che Google non ha alcuna affiliazione e non consiglia specificamente nessuna di queste terze parti.
L'URL del mio link JWT supera la limitazione del browser di 1800 caratteri. Che cosa devo fare?
Puoi creare in anticipo classi e oggetti utilizzando l'API prima di creare il link per il salvataggio della 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 sulle 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 immediatamente disponibile con un'elevata affidabilità. Non reindirizzare a file immagine che possono causare errori 404. Le immagini devono essere ospitate su una 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 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 di Google Pay e Wallet Console.
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". Quindi, descrivi il tuo feedback nell'area di testo e fai clic su "Invia".