Risorsa: GenericObject
Oggetto generico
Rappresentazione JSON |
---|
{ "genericType": enum ( |
Campi | |
---|---|
generic |
Specifica a quale |
card |
Obbligatorio. L'intestazione della tessera. In genere si tratta del nome dell'attività, ad esempio "XXX Palestra", "Assicurazione AAA". Questo campo è obbligatorio e viene visualizzato nella riga di intestazione nella parte superiore della tessera. |
subheader |
L'etichetta del titolo della tessera, ad esempio la posizione in cui è possibile utilizzare la tessera. Viene visualizzato proprio sopra il titolo nella riga del titolo nella visualizzazione dei dettagli della tessera. |
header |
Obbligatorio. Il titolo della tessera, ad esempio "Coupon 50% di sconto", "Tessera della biblioteca" o "Voucher". Questo campo è obbligatorio e viene visualizzato nella riga del titolo della visualizzazione dei dettagli della tessera. |
logo |
L'immagine del logo della tessera. Questa immagine viene visualizzata nella visualizzazione dei dettagli della scheda in alto a sinistra e anche nella visualizzazione elenco/miniatura. Se il logo non è presente, verrà mostrata la prima lettera di |
hex |
Il colore di sfondo della scheda. Se non è impostato, viene utilizzato il colore dominante dell'immagine hero. Se non è impostata un'immagine hero, viene utilizzato il colore dominante del logo. Se il logo non è impostato, Google sceglierà un colore. |
notifications |
Le impostazioni di notifica abilitate per questo oggetto. |
id |
Obbligatorio. L'identificatore univoco di un oggetto. Questo ID deve essere univoco in tutti gli oggetti di un emittente. Questo valore deve seguire il formato |
class |
Obbligatorio. La classe associata a questo oggetto. Il corso deve essere dello stesso tipo di questo oggetto, deve già esistere e deve essere approvato. Gli ID classe devono essere nel formato |
barcode |
Il tipo e il valore del codice a barre. Se la tessera non ha un codice a barre, possiamo consentire all'emittente di impostare Barcode.alternate_text e visualizzare solo questo. |
hero |
Immagine del banner visualizzata sulla parte anteriore della carta, se presente. L'immagine verrà visualizzata con una larghezza del 100%. |
valid |
Il periodo di tempo in cui questo oggetto sarà considerato valido o utilizzabile. Una volta trascorso questo periodo, l'oggetto verrà considerato scaduto, con ripercussioni sul rendering sui dispositivi dell'utente. |
image |
Dati del modulo immagine. Se sono impostati entrambi, verrà visualizzata solo un'immagine a livello di classe e una a livello di oggetto. |
text |
Dati del modulo di testo. Se |
links |
Collega i dati del modulo. Se nel corso è definito anche |
app |
Link facoltativo all'app o al sito web che verrà mostrato sotto forma di pulsante sulla parte anteriore della tessera. Se AppLinkData viene fornito per l'oggetto solo della classe corrispondente, verrà visualizzato AppLinkData. |
grouping |
Informazioni che controllano il modo in cui le tessere vengono raggruppate. |
smart |
Il valore che verrà trasmesso a un terminale certificato Smart Tap tramite NFC per questo oggetto. Affinché la tessera supporti Smart Tap, anche i campi a livello di corso |
rotating |
Impostazioni/dettagli del codice a barre rotante. |
state |
Lo stato dell'oggetto. Questo campo viene utilizzato per determinare come un oggetto viene visualizzato nell'app. Ad esempio, un oggetto |
has |
Indica se l'oggetto ha utenti. Questo campo è impostato dalla piattaforma. |
messages[] |
Un array di messaggi visualizzati nell'app. Tutti gli utenti di questo oggetto riceveranno i messaggi associati. Il numero massimo di questi campi è 10. |
pass |
Passa i vincoli per l'oggetto. Include la limitazione dei comportamenti dell'NFC e degli screenshot. |
wide |
Il logo largo della tessera. Se fornito, verrà utilizzato al posto del logo in alto a sinistra nella visualizzazione della scheda. |
save |
Restrizioni relative all'oggetto che devono essere verificate prima che l'utente provi a salvare la tessera. Tieni presente che queste limitazioni verranno applicate solo durante il periodo di salvataggio. Se le limitazioni sono cambiate dopo che un utente ha salvato la tessera, le nuove limitazioni non verranno applicate a una tessera già salvata. |
value |
Dati facoltativi del modulo a valore aggiunto. Massimo dieci nell'oggetto. |
linked |
Gli oggetti LinkedObjectId sono un elenco di altri oggetti che devono essere automaticamente associati a questo oggetto generico, ad esempio biglietto per un evento, fedeltà, offerte, prodotti generici, carte regalo, trasporto pubblico e carta d'imbarco. Se un utente avesse salvato questa scheda generica, questi linkedObjectId verrebbero inviati automaticamente al suo portafoglio (a meno che non abbia disattivato l'impostazione per ricevere queste tessere collegate). Assicurati che gli oggetti presenti in linkedObjectIds siano già inseriti. In caso contrario, le chiamate non andranno a buon fine. Una volta collegati, gli oggetti collegati non possono essere scollegati. Non puoi collegare oggetti appartenenti a un altro emittente. Esiste un limite al numero di oggetti che possono essere collegati a un singolo oggetto. Una volta raggiunto il limite, i nuovi oggetti collegati nella chiamata verranno ignorati silenziosamente. Gli ID oggetto devono seguire il formato issuer ID.identifier, dove il primo è emesso da Google e il secondo è scelto da te. |
GenericType
Il tipo di carta generica.
Enum | |
---|---|
GENERIC_TYPE_UNSPECIFIED |
Tipo generico non specificato. |
GENERIC_SEASON_PASS |
Pass per la stagione |
GENERIC_UTILITY_BILLS |
Bollette |
GENERIC_PARKING_PASS |
Tessere per il parcheggio |
GENERIC_VOUCHER |
Coupon |
GENERIC_GYM_MEMBERSHIP |
Tessere della palestra |
GENERIC_LIBRARY_MEMBERSHIP |
Tessere della biblioteca |
GENERIC_RESERVATIONS |
Prenotazioni |
GENERIC_AUTO_INSURANCE |
Tessere di assicurazione auto |
GENERIC_HOME_INSURANCE |
Tessere di assicurazione sulla casa |
GENERIC_ENTRY_TICKET |
Biglietti d'ingresso |
GENERIC_RECEIPT |
Ricevute |
GENERIC_LOYALTY_CARD |
Carte fedeltà. Tieni presente che è consigliabile utilizzare un tipo di carta fedeltà dedicato anziché questo tipo generico. Un tipo di tessera fedeltà dedicato offre più funzionalità rispetto a un tipo di tessera generica. |
GENERIC_OTHER |
Altro tipo |
Notifiche
Indica se per l'oggetto è necessario attivare la notifica. Supportiamo solo uno di ExpiryNotification/UpcomingNotification. expiryNotification
ha la precedenza su upcomingNotification
. In altre parole, se expiryNotification
è impostato, il campo upcomingNotification
viene ignorato.
Rappresentazione JSON |
---|
{ "expiryNotification": { object ( |
Campi | |
---|---|
expiry |
Verrà attivata una notifica in un momento specifico prima della scadenza della carta. |
upcoming |
Verrà attivata una notifica in un momento specifico prima che la carta diventi utilizzabile. |
ExpiryNotification
Indica che l'emittente vuole che Google Wallet invii notifiche di scadenza 2 giorni prima della scadenza della carta.
Rappresentazione JSON |
---|
{ "enableNotification": boolean } |
Campi | |
---|---|
enable |
Indica se per l'oggetto deve essere abilitata la notifica di scadenza. |
UpcomingNotification
Indica che l'emittente vuole che Google Wallet invii un'imminente notifica di validità della carta un giorno prima che la carta diventi valida/utilizzabile.
Rappresentazione JSON |
---|
{ "enableNotification": boolean } |
Campi | |
---|---|
enable |
Indica se per l'oggetto è necessario attivare la notifica di eventi imminenti. |
Metodi |
|
---|---|
|
Aggiunge un messaggio all'oggetto generico a cui fa riferimento l'ID oggetto specificato. |
|
Restituisce l'oggetto generico con l'ID oggetto specificato. |
|
Inserisce un oggetto generico con l'ID e le proprietà specificati. |
|
Restituisce un elenco di tutti gli oggetti generici per un determinato ID emittente. |
|
Aggiorna l'oggetto generico a cui fa riferimento l'ID oggetto specificato. |
|
Aggiorna l'oggetto generico a cui fa riferimento l'ID oggetto specificato. |