Автоматически связанные пропуска

Фон

Функция автоматического связывания пропусков позволяет отправлять дополнительные пропуска пользователю, у которого уже есть ваш существующий пропуск в Google Кошельке. Вы также можете предварительно связать проходы с основным проходом, когда пользователь сохраняет основной (основной) проход. Автоматически связанный пропуск сгруппирован с основным пропуском, а над основным проходом имеется выноска, информирующая пользователя о том, что новый пропуск связан. Следующие типы пропусков поддерживаются как основные или связанные проходы;

  • Билет на мероприятие
  • Посадочный талон
  • Транзитный пропуск
  • Предложение
  • Подарочная карта
  • Пропуск лояльности
  • Общий пропуск
Основной пример автоматического связанного проходаВторичный пример автоматического связанного прохода
Основной проход с пометкой о добавлении нового прохода. Новый пропуск, связанный с основным пропуском

Варианты использования

У вас могут быть разные варианты использования привязки пропусков к существующему пропуску. Вот некоторые примеры:

  • Привяжите предложение к существующей карте лояльности.
  • Привяжите ваучер на питание к посадочному талону или билету на мероприятие.
  • Привяжите пропуск на парковку к билету на мероприятие.

Некоторые соображения при использовании автоматически связанных пропусков

  • Основной объект и связанный объект должны использовать один и тот же идентификатор издателя.
  • Существует ограничение в 50 связанных объектов на один основной объект.
  • Автоматическая отправка связанных пропусков не гарантируется и считается максимально возможной. Пользователи могут отказаться от получения автоматически связанных пропусков. Если вариант использования является критическим и пользователь должен получить связанный пропуск, мы рекомендуем связаться через другой канал, чтобы гарантировать, что пользователь добавит пропуск.
  • Обновления AUP Google Кошелька включают рекомендации по использованию автоматически связанных пропусков, которые необходимо соблюдать.

Этапы интеграции

Если вы уже создали первичный объект, вы можете пропустить шаг 1.

  1. Создайте объект любого типа прохода из списка с необходимыми параметрами. Это основной объект.
  2. Создайте еще один объект любого указанного типа прохода. Это будет связанный объект.
  3. До или после сохранения основного объекта обновите основной объект, указав идентификатор связанного объекта в параметре linkedObjectIds.

Для установки linkedObjectIds на основном проходе требуется минимальная полезная нагрузка. 3 обязательных параметра включают в себя;

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

Пример запроса JSON для добавления связанного объекта в объект передачи 

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

Пример ответа JSON после привязки объекта к объекту передачи 

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

Ожидаемое поведение

После получения успешного ответа устройства с обновленным пропуском должны получить связанный пропуск. Этот связанный проход будет сгруппирован вместе с основным проходом. Пользователи могут увидеть связанный пропуск, проведя пальцем вправо.

Обработка исключений

Потенциальные ошибки могут возникнуть из-за неправильного использования API, которые могут включать в себя;

Сообщение Причина
Первичный объект и связанный объект не имеют одного и того же идентификатора издателя. Вы не можете прикрепить связанный объект к объекту другого эмитента.
Первичный объект и связанный объект относятся к одному и тому же объекту. Вы не можете прикрепить тот же объект, что и linkedObject.
Связанный объект не существует. Связанный объект уже должен быть вставлен в Wallet API.
Связанный объект уже имеет другой связанный объект. Невозможно добавить вложенные связанные объекты. Связанные объекты не могут иметь другой связанный объект.
Объект уже связан с другим объектом. Невозможно добавить вложенные связанные объекты. Первичный объект сам по себе не может быть связанным объектом.
Невозможно добавить больше связанных объектов, превышен лимит. Для основного пропуска достигнут лимит в 50 связанных пропусков.