Tipos de notificação
Adicionar mensagem e notificar
Contexto
Depois que um usuário adicionar um cartão, você poderá enviar uma mensagem relacionada à
e garanta que sejam notificados sobre isso. Usar a API Add Message
solicitação com um message_type
igual a
TEXT_AND_NOTIFY
o seguinte ocorrerá:
- Uma mensagem item é adicionado ao "verso do cartão" (ou Detalhes modelo) 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 frente do do cartão (ou seja, visualização de cartão), e o usuário verá uma frase de destaque na parte superior do com a opção "Exibir mensagem" .
- Clicar na frase de destaque levará os usuários para a parte de trás do cartão, onde novos as mensagens não lidas ficam em destaque.
Algumas considerações ao enviar mensagens com notificações aos usuários
- Os usuários precisam ativar as notificações dos cartões para receber notificações push relacionadas a mensagens.
- As mensagens podem conter URIs do seu site ou app. Os hiperlinks devem ser uma site ou app relacionado ao cartão. É uma violação das Política de Uso aceitável para 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 sua cota de entrega de notificações push considerar que você está enviando spam aos usuários.
- A notificação push que os usuários veem na tela de bloqueio é controlada pelo Google Google Wallet.
- Você pode usar o método UPDATE ou PATCH métodos para editar ou remover dados de mensagens usando a classe ou o objeto normal endpoint do Google Cloud.
Etapas de integração
Quando você quiser notificar os usuários sobre uma nova mensagem do emissor adicionada usando o API AddMessage, será necessário atualizar o objeto AddMessageRequest para que Message que contém o novo texto tem o MessageType TEXT_AND_NOTIFY em vez de TEXT.
Exemplo de solicitação JSON para adicionar uma 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 mensagens 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 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 resultará em uma QuotaExceededException . As atualizações do cartão pode ser definido usando "TEXT" em vez de TEXT_AND_NOTIFY conforme discutido no curso Integração etapas.