Activar notificaciones push

Tipos de notificación

Agregar mensaje y notificar

Información general

Después de que un usuario agregue un pase, es posible que quieras enviarle un mensaje relacionado con el pase y asegurarte de que reciba la notificación al respecto. Si usas la solicitud a la API de Add Message con un message_type igual a TEXT_AND_NOTIFY, ocurrirá lo siguiente:

  1. Se agrega un elemento "Mensaje" al "reverso del pase" (también conocido como Plantilla de detalles) y se envía una notificación push a los usuarios con el pase guardado.
  2. Una vez que el usuario presiona la notificación, se abre la Billetera de Google en la parte frontal del pase (es decir, la vista de tarjetas) y el usuario verá un texto destacado en la parte superior de la pantalla con el botón “Ver mensaje”.
  3. Cuando los usuarios hagan clic en el texto destacado, se los redireccionará al final del pase, donde se destacarán los nuevos mensajes no leídos.

Algunas consideraciones que debes tener en cuenta cuando envías mensajes con notificaciones a los usuarios

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

Pasos para la integración

Cuando quieras notificar a los usuarios sobre un nuevo mensaje de entidad emisora agregado con la API de AddMessage, deberás actualizar AddMessageRequest para que el Message que contiene tu texto nuevo tenga MessageType TEXT_AND_NOTIFY en lugar de TEXT.

Ejemplo de solicitud JSON para agregar un mensaje y notificar en una clase 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"
    },
  …

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

  …
  "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 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 respuesta QuotaExceededException . Cualquier actualización adicional del pase se puede configurar con "TEXT" en lugar de "TEXT_AND_NOTIFY", como se explica en los Pasos de integración.