Acionar notificações push

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á:

1. 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.
2. 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" .
3. 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.