Часто задаваемые вопросы по API Google Кошелька

Начиная

Что такое API Google Кошелька?

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

Как настроить среду разработки с учетом требований и сложности моего бизнеса?

Ниже приведены руководства по настройке среды разработки, отвечающей требованиям бизнеса разного уровня сложности и безопасности. Использование нескольких учётных записей служб позволяет разработчикам создавать тестовую среду отдельно от среды PROD.

Сложность базовой настройки

1 счет бизнес-консоли или 1 родительский счет бизнес-консоли для многих счетов эмитента.

  • Этот вариант позволяет реализовать централизованно управляемый подход с использованием одного основного счета с нулевым или большим количеством дочерних предприятий/эмитентов.
  • 1 Проект Google Cloud.
  • 1 учетная запись сервиса.
  • Единая группа пользователей.

Средняя сложность настройки

1 родительский счет для многих счетов эмитента.

  • Этот вариант позволяет реализовать централизованный подход с использованием одного основного счета и множества дочерних предприятий.
  • 1 Проект Google Cloud.
  • Отдельные пользователи бизнес-консоли для каждого эмитента.
  • Учетные данные от 1 до нескольких учетных записей служб.
    • 1 учетное удостоверение на предприятие/эмитента.
    • Различные учетные данные для доступа к разным предприятиям.

Сложность сложной настройки

1 родительский счет для многих счетов эмитента.

  • Этот вариант позволяет реализовать централизованный подход с использованием одного основного счета и множества дочерних предприятий.
  • От 1 до нескольких проектов Google Cloud.
  • Отдельные пользователи бизнес-консоли для каждого эмитента.
  • Учетные данные от 1 до нескольких учетных записей служб.
    • 1 учетная запись PROD на предприятие/эмитента.
    • 1 учетная запись DEV на предприятие/эмитента.

Обратитесь в службу поддержки

Работа с пропусками

Как удалить классы или объекты?

В настоящее время удалить классы и объекты из Google Wallet невозможно. Однако пользователи могут отключать объекты от своего Google Wallet.

Как сгруппировать несколько пропусков вместе?

Использование GroupingID упрощает группировку проездных.

Как обновить только часть пропуска?

Следуйте нашему руководству по производительности , чтобы понять, как выполнять частичные обновления с помощью запросов PATCH.

Могу ли я создавать пакеты пропусков?

Следуйте нашему руководству по производительности , чтобы понять, как выполнять пакетные запросы с использованием API.

Общие вопросы

Каково ограничение частоты запросов, отправляемых в API Google Wallet?

Частота вызовов API Google Wallet ограничена 20 запросами в секунду.

У API Google Wallet нет официального соглашения об уровне обслуживания (SLA), но мы рекомендуем тайм-аут в 10 секунд, исходя из 99-го процентиля задержки, составляющего около 5 секунд. Также обратите внимание, что задержка часто зависит от внешних факторов, таких как время, необходимое для загрузки изображения, размещённого на внешнем сервере, при вставке объекта с этим изображением, поскольку оно зависит от задержки внешнего сервера.

Почему в Google Wallet запрещено размещать личные изображения на пропусках?

Google Wallet не поддерживает личные изображения на пропусках, поскольку действующие правила гласят, что все потребители имеют право отказаться от сбора и обработки конфиденциальных данных. Наличие конфиденциальных данных (личных изображений) в составе ценного объекта (в JWT) может привести к проблемам с хостингом, поскольку эти данные могут стать общедоступными, что выходит за рамки первоначального соглашения о согласии. Для обеспечения конфиденциальности данных использование личных изображений запрещено. Мы работаем над поддержкой личных изображений в будущем.

Какие коды ошибок возвращает API Google Wallet?

Список кодов ошибок и исключений, возвращаемых API Google Wallet, см. в разделе Коды ошибок .

Как включить push-уведомления?

Push-уведомления, созданные разработчиками, в настоящее время не поддерживаются Google Wallet. Однако Google Wallet предоставляет своевременные уведомления для следующих карт. Push-уведомления, созданные разработчиками, в настоящее время не поддерживаются Google Wallet.

Вертикальный Уведомление Сработал Документация
Событие Предстоящее напоминание за 3 часа до мероприятия документы
Посадочный талон Предстоящее напоминание за 3 часа до вылета рейса документы
Посадочный талон Обновление пропуска Изменение терминала отправления, выхода на посадку, времени посадки или времени отправления документы
Предложение карты Напоминание об истечении срока действия 48 часов до истечения срока действия карты предложения документы
Общий Предстоящее напоминание За 24 часа до начала «временного интервала» документы
Общий Напоминание об истечении срока действия 48 часов до окончания «внутреннего времени» документы

Можно ли удалить идентификаторы торговцев?

В настоящее время идентификаторы продавцов невозможно удалить или архивировать из консоли Google Pay & Wallet.

Как использовать функцию Applinking?

Для подключения приложений требуется добавление в белый список, запросить который можно здесь.

Поддерживает ли Google Wallet функцию геозонирования?

Геозонирование в настоящее время не поддерживается.

Как настроить программу лояльности?

Вы можете настроить программу регистрации и лояльности, следуя этому руководству.

Как отправить в Google свой логотип для проездных на проезд?

Пожалуйста, воспользуйтесь этой формой , чтобы отправить логотип в Google для внесения в белый список.

Как правильно обрабатывать данные userProfile, закодированные в формате Base64?

Убедитесь, что вы используете кодировку UTF-8 на протяжении всего процесса. JSON-строка сначала кодируется в UTF-8, а затем с помощью android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 RFC 3548.

Как программно создать учетные записи эмитента?

Инструкции по созданию учетных записей эмитентов через API см. в этом руководстве.

Умное касание

Нужен ли мне специальный считыватель NFC для пропусков Google SmartTap?

Терминал должен поддерживать технологию SmartTap. Список сертифицированных поставщиков можно найти здесь.

Как сделать так, чтобы мои пропуска работали с NFC?

Пожалуйста, следуйте этой настройке , чтобы ваш пропуск можно было использовать с функцией Smart Tap.

Веб-токены JSON (JWT)

Существуют ли инструменты, упрощающие реализацию и отладку JWT?

Да, такие платформы, как www.jwt.io, позволяют декодировать и отлаживать токены в процессе разработки, что позволяет вам проверять отправляемый контент. Обратите внимание, что Google не имеет никакого отношения к подобным сторонним организациям и не рекомендует их напрямую.

Вы можете предварительно создать классы и объекты с помощью API перед созданием ссылки на сохранение пропуска (JWT).

Поиск неисправностей

Почему мои настройки времени показывают неправильное время события?

Время, отображаемое на пропуске, является местным временем события со смещением на время места проведения события.

Мой логотип не отображается на созданных мной картах. В чём может быть проблема?

  • Во-первых, убедитесь, что ваш логотип соответствует всем требованиям и сохранен в формате PNG.
  • Убедитесь, что логотип доступен и надёжен. Не перенаправляйте пользователей на файлы изображений, которые могут вызвать ошибку 404. Изображения должны размещаться на HTTPS-сервере, иначе они не будут отображаться в Google Wallet.
  • Убедитесь, что в проходе заданы все обязательные поля, отмеченные в API как обязательные.

Поддержка и обратная связь

Как связаться со службой технической поддержки?

Для получения дополнительной помощи обратитесь в службу поддержки, нажав кнопку «Связаться со службой поддержки» на левой боковой панели консоли Google Pay и Wallet .

Как оставить отзыв о продукте?

Чтобы оставить отзыв о продукте, нажмите кнопку «Отправить отзыв» в правом верхнем квадранте страницы сайта разработчика и выберите «Отзыв о продукте». Затем опишите свой отзыв в текстовом поле и нажмите «Отправить».

Как оставить отзыв о документации?

Чтобы оставить отзыв о документации, нажмите кнопку «Отправить отзыв» в правом верхнем квадранте страницы сайта разработчика и выберите «Отзыв о документации». Затем опишите свой отзыв в текстовом поле и нажмите «Отправить».