La tessera generica è disponibile quando il tuo caso d'uso non rientra in nessuno degli altri tipi di pass predefiniti. A differenza di altre tessere che includono campi e funzionalità specifici per un caso d'uso, come biglietti, carte fedeltà e offerte, la tessera generica è pensata per essere abbastanza flessibile da supportare una serie di scopi, fornendo campi in cui è possibile 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 pass generico:
- Tessere per il parcheggio
- Tessere della biblioteca
- Carte di abbonamento
- Tessere assicurative
- Conferme di prenotazioni
- Codici di conferma preliminare della schermata dei clienti
Tessere che includono informazioni sensibili
In alcuni casi, la tessera o il caso d'uso potrebbe riguardare informazioni sensibili, come informazioni che consentono l'identificazione personale (PII) e dati sanitari. In questi scenari, è disponibile il tipo di pass privato generico per i casi d'uso preapprovati. Per saperne di più, consulta la documentazione generica relativa al pass privato e le Norme di utilizzo accettabile (AUP).
Piattaforme supportate
Con l'API Google Wallet, puoi fornire tessere che i tuoi utenti potranno salvare nel loro Google Wallet su più piattaforme, incluse le app per Android, e ovunque siano supportati 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 i tuoi pass in modo facile e veloce.
- API REST Google Wallet
Per emettere tessere su piattaforme come web, email o SMS, ti consigliamo di utilizzare l'API REST di Google Wallet. L'API fornisce un insieme di endpoint che consentono di creare, recuperare e aggiornare i vari componenti delle tessere.
- SDK Google Wallet Android
Per emettere tessere in un'app per Android, ti consigliamo di utilizzare l'SDK Google Wallet per Android. L'SDK offre vari metodi pratici che semplificano l'integrazione dell'API Google Wallet nelle tue app mobile utilizzando codice nativo.
Nota: non è necessario utilizzare l'API REST di Google Wallet o l'SDK Google Wallet per Android per emettere tessere con l'API Google Wallet, ma è vivamente consigliato. Per saperne di più sull'emissione delle tessere senza utilizzare l'API REST o l'SDK Android, consulta la sezione Creazione di classi di oggetti pass e pass nel JWT.
Requisiti
Per rilasciare le tessere con l'API Google Wallet, devi prima effettuare le seguenti operazioni:- Crea un account emittente API Google Wallet.
- Sviluppatori non Android: crea un account Google Cloud.
- Sviluppatori Android: Configurare Google Play Services.
Iniziare a utilizzare l'API Google Wallet
Prima di iniziare a utilizzare l'API Google Wallet, dai un'occhiata a questi utili articoli che ti aiuteranno a familiarizzare con le funzioni e la terminologia di base.- Concetti principali e terminologia: questo articolo ti aiuterà a familiarizzare con tutti i termini e le funzionalità importanti che dovrai utilizzare con l'API Google Wallet.
- Panoramica dei pass e degli oggetti: i pass che emetti agli utenti vengono creati combinando una classe dei pass con un oggetto dei pass. In questo articolo acquisirai familiarità con entrambi i concetti e con il modo in cui vengono utilizzati per creare le tessere.
- Flusso di sviluppo delle tessere di Google Wallet: questo articolo fornisce una panoramica completa 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 spiegano i passaggi necessari per aggiungere un pass a Google Wallet. Per iniziare, scegli "Android" se l'implementazione sarà solo su dispositivi Android e scegli "Web" se l'implementazione supporta Android, Web, Email o SMS.
- Generatore di pass
Crea visivamente la tua prima tessera con lo strumento di generazione dei pass e genera automaticamente il codice JSON necessario per creare la tessera con l'API Google Wallet.
- github di Google Wallet
Ricevi strumenti, librerie e codice campione utili per diversi linguaggi di programmazione nella organizzazione GitHub di Google Wallet.