Tipos de notificação
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 sobre isso. Ao usar a solicitação Add Message API
com um message_type
igual a
TEXT_AND_NOTIFY
, ocorre o seguinte:
- Um item "Mensagem" é adicionado ao "verso do cartão" (também conhecido como modelo de detalhes), e uma notificação push é enviada aos usuários com o cartão salvo.
- Depois que o usuário toca na notificação, a Carteira do Google é aberta na frente do cartão (também conhecida como visualização de cartão), e uma frase de destaque aparece na parte de cima da tela com um botão "Ver mensagem".
- Um clique na frase de destaque leva os usuários à 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 para usuários
- Os usuários precisam ativar as notificações nos cartões para receberem notificações push relacionadas às mensagens.
- As mensagens podem conter URIs para seu site ou app. Os hiperlinks precisam ser um site ou app relacionado ao cartão. Direcionar os usuários a links não relacionados ao cartão é uma violação da Política de Uso Aceitável.
- É possível enviar no máximo três mensagens que acionam uma notificação push em um período de 24 horas. O Google poderá limitar sua cota de entrega de notificações push se você considerar que está enviando spam aos seus usuários.
- A notificação push que os usuários veem na tela de bloqueio é controlada pela Carteira do Google.
- Use os métodos UPDATE ou PATCH para editar ou remover dados de mensagens usando o endpoint normal da classe ou do objeto.
Etapas de integração
Quando você quiser notificar os usuários sobre uma nova mensagem do emissor adicionada usando a API AddMessage, precisará atualizar AddMessageRequest para que Message que contém seu novo texto tenha TEXT_AND_NOTIFY em vez de TEXT em MessageType.
Exemplo de solicitação JSON para adicionar a mensagem e notificar em uma classe de cartões
… "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 a 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 a mensagem e notificar sobre 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 produzirá uma resposta QuotaExceededException . Qualquer outra atualização do passe pode ser definida usando "TEXT" em vez de "TEXT_AND_NOTIFY", conforme discutido nas Etapas de integração.