La tessera generica è disponibile quando il tuo caso d'uso non rientra in nessuno degli altri tipi di tessera predefiniti. A differenza di altri pass che includono campi e funzionalità specifici per un caso d'uso, come biglietti, carte fedeltà e offerte, il pass generico è progettato per essere abbastanza flessibile da supportare una varietà di scopi fornendo campi in cui puoi definire etichette e valori personalizzati.
Esempi di casi d'uso
Di seguito sono riportati solo alcuni esempi di ciò che puoi fare con il tipo di tessera generica:
- Tessere per il parcheggio
- Tessere della biblioteca
- Tessere abbonamento
- Tessere dell'assicurazione
- Conferme di prenotazione
- Codici di conferma della preselezione dei clienti
Tessere che includono informazioni sensibili
In alcuni casi, la tessera o il caso d'uso potrebbero includere informazioni sensibili, come informazioni che consentono l'identificazione personale (PII) e dati sulla salute. Per questi scenari, il tipo di documento personale generico è disponibile per casi d'uso preapprovati. Per ulteriori informazioni, consulta la documentazione relativa ai documenti personali generici e le Norme di utilizzo accettabile (AUP).
Piattaforme supportate
Con l'API Google Wallet, puoi emettere tessere che gli utenti possono salvare nel proprio Google Wallet su più piattaforme, tra cui app mobile e ovunque siano supportati i link ipertestuali, ad esempio siti web, email e SMS.
API e SDK
L'API Google Wallet offre un'API REST e un SDK Android per aiutarti a emettere e gestire le tue tessere in modo rapido e semplice.
- API REST Google Wallet
Per emettere tessere su piattaforme come web, iOS o app mobile, email e SMS utilizzando i link "Aggiungi a Google Wallet", ti consigliamo di utilizzare l'API REST di Google Wallet. L'API fornisce un insieme di endpoint che ti consentono di creare, recuperare e aggiornare i vari componenti delle tessere.
- SDK Android di Google Wallet
Per emettere tessere in un'app per Android, ti consigliamo di utilizzare l'SDK Google Wallet per Android. L'SDK fornisce una serie di metodi pratici che semplificano l'integrazione dell'API Google Wallet nelle tue app mobile utilizzando il codice nativo.
Nota: l'utilizzo dell'API REST di Google Wallet o dell'SDK Android di Google Wallet non è obbligatorio per emettere tessere con l'API Google Wallet, ma è vivamente consigliato. Per ulteriori informazioni sull'emissione di tessere senza utilizzare l'API REST o l'SDK Android, consulta Creazione di oggetti e classi Passes nel JWT.
Requisiti
Per emettere tessere con l'API Google Wallet, devi prima eseguire le seguenti operazioni:- Crea un account emittente dell'API Google Wallet.
- Sviluppatori non Android: crea un account Google Cloud.
- Sviluppatori Android: configura Google Play Services.
Inizia a utilizzare l'API Google Wallet
Prima di iniziare a utilizzare l'API Google Wallet, dai un'occhiata a questi articoli utili che ti aiuteranno a familiarizzare con le funzionalità e la terminologia di base.- Concetti e terminologia chiave: questo articolo ti aiuterà a familiarizzare con tutti i termini e le funzionalità importanti di cui avrai bisogno per lavorare con l'API Google Wallet.
- Panoramica di classi e oggetti di Passes: le tessere che emetti per i tuoi utenti vengono create combinando una classe di Passes con un oggetto di Passes. Questo articolo ti aiuterà a familiarizzare con entrambi i concetti e con il modo in cui vengono utilizzati per creare le tessere.
- Flusso di sviluppo delle tessere Google Wallet: questo articolo fornisce una panoramica end-to-end di tutti i passaggi necessari per creare una tessera con l'API Google Wallet dall'inizio alla fine.
Strumenti e risorse
- Codelab
I codelab autoguidati ti illustrano i passaggi necessari per aggiungere una tessera a Google Wallet. Per iniziare, scegli "Android" se l'implementazione verrà eseguita solo su dispositivi Android e scegli "Web" se l'implementazione supporta Android, Web, email o SMS.
- Pass builder
Crea la tua prima tessera visivamente con lo strumento Pass Builder e genera automaticamente il codice JSON necessario per creare la tessera con l'API Google Wallet.
- Google Wallet GitHub
Ottieni strumenti, librerie e codice campione utili per una varietà di linguaggi di programmazione nella pagina di Google Wallet su GitHub.