Pases vinculados automáticamente

Información general

La función Pases vinculados automáticamente te permite enviar pases adicionales a una usuario que ya tiene tu pase existente en su Billetera de Google. También puedes El vínculo previo pasa a un pase principal cuando un usuario guarda el principal. pase (principal). El pase vinculado automáticamente se agrupa con el pase principal con un texto destacado sobre el pase principal en el que se informa al usuario que se otorgó un pase nuevo vinculado. Se admiten los siguientes tipos de pases como pases principales o vinculados:

  • Entrada del evento
  • Tarjeta de embarque
  • Pase de transporte público
  • Oferta
  • Tarjeta de regalo
  • Pase de lealtad
  • Pase genérico
Ejemplo principal de pase vinculado automático Ejemplo secundario de pase vinculado automático
Pase principal con el texto destacado que indica que se agregó un pase nuevo Pase nuevo vinculado al pase principal

Casos de uso

Es posible que tengas diferentes casos de uso para vincular pases a un pase existente. A continuación, se muestran algunos ejemplos:

  • Vincula una oferta a una tarjeta de lealtad existente.
  • Vincula un cupón de comida a una tarjeta de embarque o entrada para un evento.
  • Vincula un pase de estacionamiento a una entrada para evento.

Algunas consideraciones cuando se usan pases vinculados automáticamente

  • El objeto principal y el objeto vinculado deben usar el mismo publisherId.
  • Existe un límite de 50 objetos vinculados por objeto principal.
  • No se garantiza el envío automático de pases vinculados y se considera. mejor esfuerzo. Los usuarios pueden rechazar la recepción de pases vinculados automáticamente. Si el caso de uso es importantes y el usuario debe recibir el pase vinculado, te recomendamos se debe comunicar a través de otro canal para garantizar que el usuario agregue el pase.
  • Actualizaciones de la AUP de la Billetera de Google Incluir orientación sobre el uso de pases vinculados automáticamente que deben cumplirse

Pasos para la integración

Si ya creaste un objeto principal, puedes omitir el paso 1.

  1. Crea un objeto de cualquier tipo de pase de la lista. con los parámetros requeridos. Este es el objeto principal.
  2. Crea otro objeto de cualquier tipo de pase de la lista. Esta será la linked.
  3. Antes o después de guardar el objeto principal, update. el objeto principal con el ID del objeto vinculado en los linkedObjectIds parámetro.

Se requiere una carga útil mínima para configurar linkedObjectIds en una instancia que el pase. Entre los 3 parámetros obligatorios, se incluyen los siguientes:

  1. ISSUERID.PRIMARY_OBJECT_ID
  2. ISSUERID.PRIMARY_CLASS_ID
  3. ISSUERID.LINKED_OBJECT_ID

Ejemplo de solicitud JSON para agregar un objeto vinculado a un objeto pase

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

Ejemplo de respuesta JSON después de vincular un objeto a un objeto pass

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Comportamiento esperado

Tras recibir una respuesta exitosa, se actualizan los dispositivos con el pase deberían recibir el pase vinculado. Este pase vinculado se agrupará con el pase principal. Los usuarios pueden ver el pase vinculado deslizando el dedo hacia la derecha.

Manejo de excepciones

Los posibles errores pueden ocurrir con el uso incorrecto de la API, lo que puede incluir;

Mensaje Motivo
El objeto principal y el objeto vinculado no comparten la misma entidad emisora ID. No puedes adjuntar un objeto vinculado al objeto de otra entidad emisora.
El objeto principal y el objeto vinculado hacen referencia al mismo objeto. No puedes adjuntar el mismo objeto que linkedObject.
El objeto vinculado no existe. El objeto vinculado ya debería estar insertado en la Billetera en la API de Cloud.
El objeto vinculado ya tiene otro objeto vinculado. No se pueden agregar elementos anidados vinculados. Los objetos vinculados no pueden tener otro objeto vinculado.
El objeto ya está vinculado a otro. No se pueden agregar vínculos anidados objetos. El objeto principal no puede ser un objeto vinculado por sí solo.
No se pueden agregar más objetos vinculados porque se superó el límite. Se alcanzó el límite de 50 pases vinculados para el principal que el pase.