Activar notificaciones push

Tipos de notificación

Agregar mensaje y notificar

Información general

Después de que un usuario agrega un pase, puedes enviarle un mensaje relacionado con el aprobar y garantizar que reciban notificaciones al respecto. Con la API de Add Message solicitud con un message_type igual a TEXT_AND_NOTIFY ocurre lo siguiente:

  1. Un "Mensaje" el elemento se agrega al “reverso del pase” (es decir, Detalles plantilla) y se envía una notificación push a los usuarios que tengan el pase guardado.
  2. Una vez que el usuario presiona la notificación, se abre la Billetera de Google en el frente de pase (también conocido como vista de tarjetas), y el usuario verá un texto destacado en la parte superior con el mensaje "Ver mensaje" .
  3. Cuando los usuarios hagan clic en el texto destacado, se los redirigirá a la parte posterior del pase, donde las nuevas los mensajes no leídos aparecen destacados.

Algunas consideraciones a la hora de enviar mensajes con notificaciones a los usuarios

  • Los usuarios deben tener habilitadas las notificaciones para que sus pases reciban las notificaciones push relacionadas con los mensajes.
  • Los mensajes pueden contener URI de tu sitio web o aplicación. Los hipervínculos deben ser sitio web o app relacionados con el pase. Es un incumplimiento de la Política de Uso Aceptable para enviar a los usuarios a vínculos no relacionados con el pase.
  • Puedes enviar un máximo de 3 mensajes que activen una notificación push en un un período de 24 horas. Es posible que Google limite tu cuota de entrega de notificaciones push si considera que estás enviando spam a tus usuarios.
  • Google controla la notificación push que los usuarios ven en su pantalla de bloqueo Google Wallet.
  • Puedes usar UPDATE o PATCH métodos para editar o quitar datos de mensajes usando el objeto o la clase normal extremo.

Pasos para la integración

Si deseas notificar a los usuarios sobre un nuevo mensaje de entidad emisora agregado a través del AddMessage, deberás actualizar AddMessageRequest para que el Message que contiene el texto nuevo, tiene el valor MessageType TEXT_AND_NOTIFY en lugar de TEXT

Ejemplo de solicitud de JSON para agregar un mensaje y notificar en una clase Pases

  …
  "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"
    },
  …

Ejemplo de solicitud JSON para agregar un mensaje y notificar en un objeto Pases

  …
  "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"
    },
  …

Respuesta de ejemplo para agregar un mensaje y notificar a una clase Pass

  // 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"
    },
  …

Manejo de excepciones

Cualquier intento de notificación más de 3 veces generará una QuotaExceededException . Cualquier actualización posterior al se puede configurar el pase con "TEXT" en vez de “TEXT_AND_NOTIFY” como se explica en el curso Integración Pasos.