Начиная
Что такое API Google Кошелька?
API Google Wallet позволяет разработчикам создавать цифровые проходы в Google Wallet. API Google Кошелька в настоящее время поддерживает посадочные талоны, билеты на мероприятия, карты лояльности, предложения и проездные билеты. Совсем недавно был добавлен общий тип прохода для поддержки дополнительных вариантов использования.
Исключения API и устранение неполадок
- Что означает это исключение?
Если вы столкнулись с какими-либо исключениями API при работе с Google Wallet API, см. следующую таблицу, чтобы найти объяснения и предложения:
Исключение Пример сообщения Предположение 400 – Бадрекуестексцептион Запрос содержит недопустимый аргумент. Недопустимый идентификатор ресурса: {1234567891234567899 - ABCD1234567}. Проверьте структуру данных на тип, формат и длину и передайте правильный аргумент. 403 - Исключение отказа в разрешении Доступ запрещен Убедитесь, что правильный адрес электронной почты учетной записи службы является авторизованным пользователем в вашей консоли Business Pay и Wallet. 404 – исключение NotFoundException Объект кошелька {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} не найден. Выполните GET для идентификатора объекта перед попыткой перед запросом PATCH или PUT , чтобы убедиться, что у вас есть объект для обновления и что он самый последний. 404 - Исключение IssuerClassNotFoundException Класс объекта кошелька {1234567891234567899.ABCD.1234567} не найден. При выполнении обновления убедитесь, что вы делаете запрос GET перед запросом PATCH или PUT , чтобы убедиться, что у вас есть класс для ссылки на то, что это последний класс. Также убедитесь, что в запросе используется правильная полезная нагрузка (объект и класс). 409 - Уже существует исключение Класс объекта кошелька {1234567891234567899.ABCD.1234567} уже существует. Выполните GET для идентификатора класса, прежде чем пытаться создать такой же идентификатор класса. Если ресурс существует, вы можете использовать PATCH или PUT. - Во-первых, убедитесь, что ваш логотип соответствует рекомендациям и сохранен в формате PNG.
- Убедитесь, что логотип легко доступен с высокой надежностью. Не перенаправлять на файлы изображений, которые могут вызвать ошибку 404. Ваши изображения должны размещаться по протоколу HTTPS, иначе они не будут видны в Google Кошельке.
- Убедитесь, что все обязательные поля, отмеченные как обязательные в API, заданы в проходе.
- Этот вариант позволяет использовать централизованно управляемый подход с использованием 1 основной учетной записи с нулевым или несколькими дочерними предприятиями/эмитентами.
- 1 облачный проект Google.
- 1 учетная запись службы.
- Единый набор пользователей.
- Этот вариант позволяет использовать централизованно управляемый подход с использованием 1 основной учетной записи с множеством дочерних компаний.
- 1 облачный проект Google.
- Отдельные пользователи бизнес-консоли для каждого эмитента.
- 1 ко многим учетным данным служебной учетной записи.
- 1 учетная запись на компанию/эмитента.
- Разный доступ к учетным данным для каждого бизнеса.
- Этот вариант позволяет использовать централизованно управляемый подход с использованием 1 основной учетной записи с множеством дочерних компаний.
- 1 из многих облачных проектов Google.
- Отдельные пользователи бизнес-консоли для каждого эмитента.
- 1 ко многим учетным данным служебной учетной записи.
- 1 учетная запись PROD на компанию/эмитента.
- 1 учетная запись DEV на компанию/эмитента.
Общие вопросы
Как включить push-уведомления?
Push-уведомления, созданные разработчиками, в настоящее время не поддерживаются Google Кошельком. Однако Google Wallet предоставляет своевременные уведомления для следующих проходов. Push-уведомления, созданные разработчиками, в настоящее время не поддерживаются Google Кошельком.
| Вертикальный | Уведомление | Запущено | Документация |
|---|---|---|---|
| Событие | Предстоящее напоминание | за 3 часа до мероприятия | документы |
| Посадочный талон | Предстоящее напоминание | за 3 часа до вылета рейса | документы |
| Посадочный талон | Пройти обновление | Терминал отправления, выход на посадку, изменение времени посадки или времени отправления | документы |
| Карта предложения | Напоминание об истечении срока действия | 48 часов до истечения срока действия карты предложения | документы |
| Общий | Предстоящее напоминание | За 24 часа до начала «временного интервала» | документы |
| Общий | Напоминание об истечении срока действия | 48 часов до окончания «внутреннего времени» | документы |
Можно ли удалить идентификаторы продавца?
В настоящее время идентификаторы продавцов нельзя удалить или заархивировать в консоли Google Pay & Wallet.
Как удалить классы или объекты?
В настоящее время вы не можете удалять курсы или объекты из Google Кошелька. Однако пользователи могут удалить объекты из своего Google Кошелька.
Как использовать функцию Applinking?
Для связывания приложений требуется белый список, который можно запросить здесь.
Почему в моих настройках времени отображается неправильное время события?
Время, отображаемое на пропуске, является локальным временем события со смещением относительно времени, в котором произошло событие.
Поддерживает ли Google Wallet геозону?
В настоящее время геозоны не поддерживаются.
Как настроить программу лояльности?
Вы можете настроить регистрацию и программу лояльности, следуя этому руководству.
Как отправить Google свой логотип для транзитных проездных?
Используйте эту форму , чтобы отправить Google логотип для внесения в белый список.
Мой логотип не будет отображаться на созданных мной проходах. Что может быть не так?
Существуют ли инструменты, которые упрощают реализацию и отладку JWT?
Да, такие платформы, как www.jwt.io , позволяют вам декодировать и отлаживать ваши токены в процессе разработки, что позволяет вам проверять отправляемый вами контент. Обратите внимание, что Google не имеет никакого отношения к таким третьим сторонам и не рекомендует их конкретно.
Как правильно обрабатывать данные профиля пользователя в кодировке Base64?
Убедитесь, что вы используете кодировку UTF-8 на протяжении всего процесса. Строка JSON сначала кодируется UTF-8, а затем кодируется с использованием android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 RFC 3548.
Как сгруппировать несколько проходов вместе?
Использование GroupingID позволяет легко группировать проходы вместе.
Как программно создать учетные записи эмитента?
См. это руководство , чтобы создать учетные записи эмитента через API.
URL-адрес моей ссылки JWT превышает ограничение браузера на 1800 символов. Что я должен делать?
Вы можете предварительно создать классы и объекты с помощью API перед созданием ссылки для сохранения (JWT).
Как обновить только часть пропуска?
Следуйте нашему руководству по производительности , чтобы понять, как выполнять частичные обновления с помощью запросов PATCH.
Могу ли я создавать пакеты в пакетном режиме?
Следуйте нашему руководству по производительности , чтобы понять, как выполнять пакетные запросы с помощью API.
Умный кран
Нужен ли мне специальный считыватель NFC для пропусков Google SmartTap?
Это должен быть терминал с поддержкой SmartTap. Список сертифицированных поставщиков можно найти здесь.
Как заставить мои пропуска работать с NFC?
Пожалуйста, следуйте этой конфигурации , чтобы ваш пропуск можно было погасить с помощью Smart Tap.
Настройка разработчика
Как мне настроить среду разработки в соответствии с требованиями и сложностью моего бизнеса?
Ниже приведены руководства, которые можно использовать для настройки среды разработки, соответствующей различным уровням сложности бизнеса и безопасности. Использование нескольких учетных записей служб позволяет разработчикам создавать среду TEST отдельно от среды PROD.
Базовая сложность настройки
1 учетная запись бизнес-консоли или 1 родительская учетная запись бизнес-консоли для нескольких учетных записей эмитента.
Средняя сложность настройки
1 родительская учетная запись для многих учетных записей эмитента.
Сложная сложность настройки
1 родительская учетная запись для многих учетных записей эмитента.
Как связаться со службой технической поддержки?
Для получения дополнительной помощи обратитесь в службу поддержки через консоль Google Pay и Wallet.
Оставить отзыв
Как оставить отзыв о товаре?
Чтобы оставить отзыв о продукте, нажмите кнопку «Отправить отзыв» в правом верхнем углу страницы сайта разработчика и выберите «Отзыв о продукте». Далее опишите свой отзыв в текстовой области и нажмите «Отправить».
Как оставить отзыв о документации?
Чтобы оставить отзыв о документации, нажмите кнопку «Отправить отзыв» в правом верхнем углу страницы сайта разработчика и выберите «Отзыв о документации». Далее опишите свой отзыв в текстовой области и нажмите «Отправить».