Фон
Функция автоматического связывания пропусков позволяет отправлять дополнительные пропуска пользователю, у которого уже есть существующий пропуск в Google Кошельке. Вы также можете предварительно связать проходы с основным проходом, когда пользователь сохраняет основной (основной) проход. Автоматически связанный пропуск сгруппирован с основным пропуском, а над основным проходом имеется выноска, информирующая пользователя о том, что новый пропуск связан. Следующие типы пропусков поддерживаются как основные или связанные проходы;
- Билет на мероприятие
- Посадочный талон
- Транзитный пропуск
- Предложение
- Подарочная карта
- Пропуск лояльности
- Общий пропуск
Случаи использования
У вас могут быть разные варианты использования привязки пропусков к существующему пропуску. Вот некоторые примеры:
- Привяжите предложение к существующей карте лояльности.
- Привяжите ваучер на питание к посадочному талону или билету на мероприятие.
- Привяжите пропуск на парковку к билету на мероприятие.
Некоторые соображения по использованию автоматически связанных пропусков
- Основной объект и связанный объект должны использовать один и тот же идентификатор издателя.
- Существует ограничение в 50 связанных объектов на один основной объект.
- Автоматическая отправка связанных пропусков не гарантируется и считается максимально возможной. Пользователи могут отказаться от получения автоматически связанных пропусков. Если вариант использования является критическим и пользователь должен получить связанный пропуск, мы рекомендуем связаться через другой канал, чтобы гарантировать, что пользователь добавит пропуск.
- Обновления AUP Google Кошелька включают рекомендации по использованию автоматически связанных пропусков, которые необходимо соблюдать.
Этапы интеграции
Если вы уже создали основной объект, вы можете пропустить шаг 1.
- Создайте объект любого типа прохода из списка с необходимыми параметрами. Это основной объект.
- Создайте еще один объект любого указанного типа прохода. Это будет связанный объект.
- До или после сохранения основного объекта обновите основной объект, указав идентификатор связанного объекта в параметре linkedObjectIds.
Для установки linkedObjectIds на основном проходе требуется минимальная полезная нагрузка. 3 обязательных параметра включают в себя;
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- 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 связанных пропусков. |