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

Начиная

Что такое API Google Wallet?

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

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

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

Базовая сложность настройки

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

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

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

Один родительский счет может обслуживать множество счетов эмитентов.

  • Этот вариант позволяет использовать централизованный подход с одним основным аккаунтом и множеством дочерних предприятий.
  • 1. Проект Google Cloud.
  • Отдельные пользователи бизнес-консоли от каждого эмитента.
  • От 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-уведомления?

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

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

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

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

Как использовать функцию привязки приложений?

Для добавления приложения в список разрешенных приложений необходимо внести его в список разрешенных, запрос на это можно подать здесь.

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

Да, это поддерживается. Для получения дополнительной информации см. раздел «Запуск push-уведомлений» для соответствующего типа пароля.

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

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

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

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

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

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

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

Для создания учетных записей эмитентов через API воспользуйтесь этим руководством .

Умный кран

Для использования пропусков Google SmartTap требуется специальный NFC-считыватель?

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

Как мне настроить работу моих пропусков с NFC?

Для активации функции Smart Tap на вашем пропуске выполните следующие действия .

JSON-токены (JWT)

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

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

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

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

Почему в настройках времени отображается неверное время события?

Время, отображаемое на пропуске, соответствует местному времени мероприятия с погрешностью, учитывающей время в месте проведения мероприятия.

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

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

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

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

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

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

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

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

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