Автоматическое добавление посадочных талонов

Фон

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

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

Примечание: Эта функция представляет собой конкретную реализацию возможности "Автоматически связанные проходы". В остальной части документа для описания этой функциональности используется более широкий термин "Автоматически связанные проходы", а также "основной проход" и "связанный проход".

Как работает эта функция

Шаг 1: Предоставьте часто путешествующему пользователю возможность добавить свой купон лояльности в Wallet.

Шаг 2: Автоматически добавляйте новые посадочные талоны для часто летающих пассажиров, привязывая их к их карте лояльности в Wallet.

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

• Основной объект и связанный объект должны использовать один и тот же идентификатор эмитента (summerId).
• На один основной объект приходится не более 50 связанных объектов.
• Автоматическая отправка связанных пропусков не гарантируется и считается «максимально возможной». Пользователи могут отказаться от получения автоматически связанных пропусков. Если сценарий использования критически важен и пользователю необходимо получить связанный пропуск, мы рекомендуем связаться с ним по другому каналу, чтобы убедиться, что он добавит пропуск.
• В обновленную версию правил использования Google Wallet включены рекомендации по использованию автоматически связанных пропусков, которые необходимо соблюдать.

Шаги интеграции

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

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

Для установки идентификаторов связанных объектов (linkedObjectIds) на первом этапе требуется минимальный объем полезной нагрузки. К числу обязательных параметров относятся:

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

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

  …
  {
    "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, в том числе: