Tessere collegate automaticamente

Sfondo

La funzionalità Tessere collegate automaticamente ti consente di inviare tessere aggiuntive a un utente che ha già inserito la tua tessera in Google Wallet. Puoi anche tessere pre-collegamento a una tessera principale quando un utente salva quella principale (principale). La tessera collegata automaticamente è raggruppata con la tessera principale con un callout sopra il pass principale per informare l'utente che è stato eseguito collegato. I seguenti tipi di tessere sono supportati come tessere principali o collegate.

  • Biglietto evento
  • Carta d'imbarco
  • Pass per il trasporto pubblico
  • Offerta
  • Carta regalo
  • Carte fedeltà
  • Tessera generica
di Gemini Advanced.
Esempio principale di tessera collegata automaticamente Esempio secondario tessera collegata automaticamente
Tessera principale con il callout che indica che è stata aggiunta una nuova tessera Nuova tessera collegata alla tessera principale

Casi d'uso

Potrebbero esserci diversi casi d'uso per collegare le tessere a una tessera esistente. Alcune Ecco alcuni esempi:

  • Collega un'offerta a una carta fedeltà esistente.
  • Collega un buono pasto a una carta d'imbarco o a un biglietto per un evento.
  • Collega un pass per il parcheggio a un biglietto per un evento.

Alcune considerazioni sull'utilizzo dei pass collegati automaticamente

  • L'oggetto principale e l'oggetto collegato devono utilizzare lo stesso IssuerId.
  • Esiste un limite di 50 oggetti collegati per oggetto principale.
  • Il trasferimento automatico delle tessere collegate non è garantito e considerato con il criterio del "best effort". Gli utenti possono disattivare la ricezione dei pass collegati automaticamente. Se il caso d'uso è fondamentale e l'utente deve ricevere la tessera collegata, consigliamo comunicare attraverso un altro canale per assicurarsi che l'utente aggiunga la tessera.
  • Aggiornamenti alle AUP (Acceptable Use Policy, norme di utilizzo accettabile) di Google Wallet includere indicazioni sull'uso dei pass collegati automaticamente che devono essere rispettate.

Passaggi per l'integrazione

Se hai già creato un oggetto principale, puoi saltare il passaggio 1.

  1. Crea un oggetto di qualsiasi tipo di tessera elencato con i parametri richiesti. Questo è l'oggetto principale.
  2. Crea un altro oggetto di qualsiasi tipo di tessera elencato. Questa sarà la collegato.
  3. Prima o dopo il salvataggio dell'oggetto principale, aggiorna l'oggetto principale con l'ID dell'oggetto collegato nei campi linkedObjectId .

È richiesto un payload minimo per impostare linkedObjectIds su un vengono superate. I 3 parametri obbligatori includono:

  1. ISSUERID.PRIMARY_OBJECT_ID
  2. ISSUERID.PRIMARY_CLASS_ID
  3. ISSUERID.LINKED_OBJECT_ID

Richiesta JSON di esempio per aggiungere un oggetto collegato a un oggetto pass

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

Esempio di risposta JSON dopo il collegamento di un oggetto a un oggetto pass

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Comportamento previsto

Dopo aver ricevuto una risposta positiva, i dispositivi con la tessera che hai aggiornato dovresti ricevere la tessera collegata. Questa tessera collegata verrà raggruppata con il pass principale. Gli utenti possono vedere la tessera collegata scorrendo verso destra.

Gestione delle eccezioni

Potrebbero verificarsi errori se l'API viene utilizzata in modo non corretto, il che può includere:

Messaggio Motivo
L'oggetto principale e l'oggetto collegato non condividono lo stesso emittente ID. Non puoi collegare un oggetto collegato all'oggetto di un altro emittente.
Oggetto principale e oggetto collegato fanno riferimento allo stesso oggetto. Non puoi collegare lo stesso oggetto di LinkedObject.
L'oggetto collegato non esiste. L'oggetto collegato deve essere già inserito in Wallet tramite Google Cloud CLI o tramite l'API Compute Engine.
L'oggetto collegato ha già un altro oggetto collegato. Impossibile aggiungere elementi nidificati oggetti collegati. Gli oggetti collegati non possono avere altri oggetti collegati.
L'oggetto è già collegato a un altro oggetto. Impossibile aggiungere elementi collegati nidificati di oggetti strutturati. L'oggetto principale non può essere di per sé un oggetto collegato.
Impossibile aggiungere altri oggetti collegati, limite superato. È stato raggiunto il limite di 50 tessere collegate per la carta principale vengono superate.