Attiva notifiche push
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Notifiche attivate dal partner
Aggiungi messaggio e Avvisa
Sfondo
Dopo che un utente ha aggiunto una tessera, potresti volergli inviare un messaggio relativo alla tessera e assicurarti che riceva una notifica. Se utilizzi la richiesta dell' API Add Message con un valore message_type uguale a TEXT_AND_NOTIFY, si verifica quanto segue:
- Un elemento "Messaggio" viene aggiunto al "retro della tessera" (noto anche come Modello dettagli) e viene inviata una notifica push agli utenti con la tessera salvata.
- Quando l'utente tocca la notifica, Google Wallet si apre sulla parte anteriore della tessera (ovvero nella visualizzazione Scheda) e l'utente vedrà un callout nella parte superiore della schermata con un pulsante "Visualizza messaggio".
- Se fanno clic sul callout, gli utenti vengono indirizzati al retro della tessera, dove sono evidenziati i nuovi messaggi non letti.
Alcune considerazioni sull'invio di messaggi con notifiche agli utenti
- Per ricevere le notifiche push relative ai messaggi, gli utenti devono aver attivato le notifiche per le tessere.
- I messaggi possono contenere URI che rimandano al tuo sito web o alla tua app. I link ipertestuali devono rimandare a un sito web o un'app correlati alla tessera. È una violazione delle Norme relative all'utilizzo accettabile inviare gli utenti a link non correlati alla tessera.
- Puoi inviare un massimo di 3 messaggi che attivano una notifica push nell'arco di 24 ore. Google potrebbe limitare la quota di invio delle notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
- La notifica push visualizzata dagli utenti nella schermata di blocco è controllata da Google Wallet.
- Puoi utilizzare i metodi UPDATE o PATCH per modificare o rimuovere i dati dei messaggi utilizzando l'endpoint di classe o oggetto normale.
Passaggi per l'integrazione
Quando vuoi notificare agli utenti un nuovo messaggio del gestore aggiunto utilizzando l'API AddMessage, devi aggiornare AddMessageRequest in modo che il Message contenente il nuovo testo abbia MessageType
TEXT_AND_NOTIFY anziché TEXT.
Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in una classe di documenti di viaggio
…
"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 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 un corso superato
// 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 invio di notifiche per più di 3 volte restituirà una risposta QuotaExceededException . Eventuali aggiornamenti successivi alla
pass possono essere impostati utilizzando "TEXT" anziché
"TEXT_AND_NOTIFY", come descritto nella sezione Passaggi di integrazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-03 UTC.
[null,null,["Ultimo aggiornamento 2025-09-03 UTC."],[[["\u003cp\u003eSend messages to Google Wallet pass users and trigger a push notification using the \u003ccode\u003eTEXT_AND_NOTIFY\u003c/code\u003e message type with the Add Message API.\u003c/p\u003e\n"],["\u003cp\u003eUsers will see a callout on their saved pass prompting them to view the new message, leading them to the pass details.\u003c/p\u003e\n"],["\u003cp\u003eYou can send a maximum of 3 notification-triggering messages per pass within a 24-hour period, with potential throttling for excessive notifications.\u003c/p\u003e\n"],["\u003cp\u003eThe message content can include links to relevant websites or apps associated with the pass, adhering to Google's Acceptable Use Policy.\u003c/p\u003e\n"],["\u003cp\u003eMessages and notifications can be managed through the \u003ccode\u003eUPDATE\u003c/code\u003e or \u003ccode\u003ePATCH\u003c/code\u003e methods for editing or removal.\u003c/p\u003e\n"]]],["The `Add Message API` with `message_type` as `TEXT_AND_NOTIFY` adds a message to the pass's back and sends a push notification. Users tap the notification to view the pass and then access the message, highlighted as unread. Messages can include URIs relevant to the pass. A maximum of 3 notifications are allowed per 24 hours. Use the `AddMessageRequest` and set `MessageType` to `TEXT_AND_NOTIFY`. Exceeding the notification limit triggers a `QuotaExceededException`. `TEXT` can still be used.\n"],null,["# Trigger Push Notifications\n\nPartner Triggered Notifications\n-------------------------------\n\n### Add Message and Notify\n\n#### Background\n\nAfter a user adds a pass you may want to send them a message related to the\npass and ensure they are notified about it. Using the [Add Message API](/wallet/generic/rest/v1/genericclass/addmessage)\nrequest with a `message_type` equal to\n**`TEXT_AND_NOTIFY`** the following occurs:\n\n1. A \"[Message](https://developers.google.com/wallet/reference/rest/v1/Message)\" item is added to the \"back of pass\" (aka [Details\n Template](/wallet/generic/resources/template#details-template)) and a push notification is sent to users with the pass saved.\n2. Once the user taps the notification it opens Google Wallet to the front of the pass (a.k.a. Card view) and the user will see a callout at the top of the screen with a \"View Message\" button.\n3. Clicking the callout will take users to the back of the pass, where new unread messages are highlighted.\n\n#### Some considerations when sending messages with notifications to users\n\n- Users must have notifications enabled for their passes to receive the push notifications related to messages.\n- Messages may contain URIs to your website or app. Hyperlinks must be a website or app related to the pass. It is a violation of the [Acceptable Use Policy](https://payments.developers.google.com/terms/aup) to send users to links not related to the pass.\n- You may send a maximum of 3 messages that trigger a push notification in a 24 hour period. Google may throttle your push notification delivery quota if it deems you are spamming your users.\n- The push notification users see on their lock screen is controlled by Google Wallet.\n- You can use the [UPDATE](/wallet/generic/rest/v1/genericclass/update) or [PATCH](/wallet/generic/rest/v1/genericclass/patch) methods to edit or remove message data using the regular class or object endpoint.\n\n#### Integration Steps\n\nWhen you want to notify users about a new issuer message added using the\nAddMessage API, you will need to update the [AddMessageRequest](https://developers.google.com/wallet/reference/rest/v1/AddMessageRequest)\nso that the [Message](https://developers.google.com/wallet/reference/rest/v1/Message)\nwhich contains your new text has the [MessageType](https://developers.google.com/wallet/reference/rest/v1/Message#MessageType)\n**TEXT_AND_NOTIFY** instead of **TEXT**.\n\n#### Example JSON Request to add message and notify in a Passes Class\n\n```carbon\n ...\n \"id\": ISSUER_ID.CLASS_ID\",\n \"message\":\n {\n \"header\":\"My Class message header\",\n \"body\": \"My Class message body with a \u003ca href=\"https://wallet.google\"\u003eHyperlink\u003c\\a\u003e\",\n \"id\": \"message_id\",\n \"message_type\": \"TEXT_AND_NOTIFY\"\n },\n ...\n```\n\n#### Example JSON Request to add message and notify in a Passes Object\n\n```carbon\n ...\n \"id\": OBJECT_ID\",\n \"classId\": \"ISSUER_ID.CLASS_ID\",\n \"message\":\n {\n \"header\":\"My Object message header\",\n \"body\": \"My Object message body with a \u003ca href=\"http://play.google.com/store/apps/details?id=com.google.android.apps.maps\"\u003eHyperlink\u003c\\a\u003e\",\n \"id\": \"message_id\",\n \"message_type\": \"TEXT_AND_NOTIFY\"\n },\n ...\n```\n\n#### Example [Response](/wallet/generic/rest/v1/genericclass/addmessage#response-body) to add message and notify for a Pass Class\n\n```scilab\n // The updated resource\n …\n {\n \"kind\": \"walletobjects#walletObjectMessage\",\n \"header\": \"My Object message header\",\n \"body\": \"My Object message body with a \u003ca href=\"http://play.google.com/store/apps/details?id=com.google.android.apps.maps\"\u003eHyperlink\u003c\\a\u003e\",\n \"id\": \"message_id\",\n \"messageType\": \"textAndNotify\"\n },\n …\n```\n\n#### Exception handling\n\nAny attempts to notify more than 3 times will yield a\n**QuotaExceededException** response. Any further updates to the\npass can be set using \"**TEXT** \" instead of\n\"**TEXT_AND_NOTIFY** \" as discussed in the [Integration\nSteps](#add-message-and-notify-integration-steps)."]]
