Tipi di notifiche
Aggiungi messaggio e notifica
Contesto
Dopo che un utente ha aggiunto una tessera, puoi inviargli un messaggio relativo alla tessera e assicurarti che ne riceva una notifica. Se utilizzi la richiesta Add Message API con un valore di message_type uguale a TEXT_AND_NOTIFY, si verifica quanto segue:
- Una voce "Message" viene aggiunta al "retro della tessera" (noto anche come Details Template) e viene inviata una notifica push agli utenti con la tessera salvata.
- Dopo che l'utente tocca la notifica, Google Wallet apre la parte anteriore della tessera (ovvero la visualizzazione carta) e l'utente vede un callout nella parte superiore dello schermo con un pulsante "Visualizza messaggio".
- Se fanno clic sul callout, l'utente viene indirizzato alla parte posteriore della tessera, dove sono evidenziati i nuovi messaggi da leggere.
Alcune considerazioni da fare durante l'invio di messaggi con notifiche agli utenti
- Per poter ricevere le notifiche push relative ai messaggi, gli utenti devono aver abilitato le notifiche per le proprie tessere.
- I messaggi possono contenere URI al tuo sito web o alla tua app. I link ipertestuali devono essere un sito web o un'app correlati al pass. Indirizzare gli utenti a link non correlati al pass costituisce una violazione delle Norme di utilizzo accettabile.
- Puoi inviare un massimo di tre messaggi che attivano una notifica push in un periodo di 24 ore. Google potrebbe limitare la tua quota di recapito delle notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
- Le notifiche push che gli utenti vedono nella schermata di blocco sono controllate da Google Wallet.
- Puoi utilizzare i metodi UPDATE o PATCH per modificare o rimuovere i dati dei messaggi utilizzando il normale endpoint di classe o di oggetto.
Passaggi per l'integrazione
Quando vuoi informare gli utenti di un nuovo messaggio dell'emittente aggiunto utilizzando l'API AddMessage, devi aggiornare AddMessageRequest in modo che il campo Message che contiene il nuovo testo abbia il valore MessageType TEXT_AND_NOTIFY anziché TEXT.
Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in una classe Passes
…
"id": ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Class message header",
"body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in un oggetto Passes
…
"id": OBJECT_ID",
"classId": "ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
Esempio di Risposta per aggiungere un messaggio e inviare una notifica per una classe Pass
// The updated resource
…
{
"kind": "walletobjects#walletObjectMessage",
"header": "My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"messageType": "textAndNotify"
},
…
Gestione delle eccezioni
Qualsiasi tentativo di inviare una notifica più di 3 volte genererà una risposta QuotaExceededException . Eventuali ulteriori aggiornamenti alla tessera possono essere impostati utilizzando "TEXT" invece di "TEXT_AND_NOTIFY", come descritto nei passaggi di integrazione.