Acionar notificações push
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Notificações acionadas pelo parceiro
Adicionar mensagem e notificar
Contexto
Depois que um usuário adiciona um cartão, você pode enviar uma mensagem relacionada a ele e garantir que ele seja notificado. Ao usar a solicitação da API Add Message
com um message_type igual a
TEXT_AND_NOTIFY, o seguinte ocorre:
- Um item Mensagem é adicionado à "parte de trás do cartão" (também conhecida como Modelo de
detalhes) e uma notificação push é enviada aos usuários com o cartão salvo.
- Quando o usuário toca na notificação, a Carteira do Google é aberta na parte frontal do cartão (também conhecida como visualização de cartão), e o usuário vê um ícone de destaque na parte de cima da tela com um botão "Ver mensagem".
- Ao clicar no destaque, os usuários vão acessar a parte de trás do cartão, onde as novas
mensagens não lidas são destacadas.
Algumas considerações ao enviar mensagens com notificações aos usuários
- Os usuários precisam ter as notificações ativadas para que os cartões recebam as
notificações push relacionadas a mensagens.
- As mensagens podem conter URIs para seu site ou app. Os hiperlinks precisam ser um site ou app relacionado ao cartão. É uma violação da Política de uso aceitável direcionar os usuários a links não relacionados ao cartão.
- Você pode enviar no máximo três mensagens que acionam uma notificação push em um
período de 24 horas. O Google pode limitar a cota de envio de notificações push se
considerar que você está enviando spam para os usuários.
- A notificação push que os usuários veem na tela de bloqueio é controlada pelo Google
Wallet.
- É possível usar os métodos UPDATE
ou PATCH
para editar ou remover dados de mensagens usando o endpoint de classe ou objeto
regular.
Etapas de integração
Quando você quiser notificar os usuários sobre uma nova mensagem do emissor adicionada usando a
API AddMessage, será necessário atualizar a AddMessageRequest
para que a Message
que contém o novo texto tenha o MessageType
TEXT_AND_NOTIFY em vez de TEXT.
Exemplo de solicitação JSON para adicionar mensagem e notificar em uma classe de 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"
},
…
Exemplo de solicitação JSON para adicionar mensagem e notificar em um objeto de cartões
…
"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"
},
…
Exemplo de resposta para adicionar uma mensagem e notificar uma classe de cartão
// 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"
},
…
Como processar exceções
Qualquer tentativa de notificar mais de três vezes vai gerar uma resposta
QuotaExceededException . Outras atualizações do cartão podem ser definidas usando "TEXT" em vez de
"TEXT_AND_NOTIFY", conforme discutido nas etapas de integração.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-04 UTC.
[null,null,["Última atualização 2025-09-04 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)."]]
