Часто задаваемые вопросы о Google Wallet API

Начало работы

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

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

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

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

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

Один аккаунт Business Console или один родительский аккаунт Business Console для нескольких аккаунтов эмитента.

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

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

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

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

Сложная настройка

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

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

Служба поддержки

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

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

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

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

Используя GroupingID, можно легко группировать карты.

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

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

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

В нашем руководстве по повышению эффективности рассказывается, как выполнять пакетные запросы с помощью API.

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

Какое ограничение частоты запросов действует для Google Wallet API?

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

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

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

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

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

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

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

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

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

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

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

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

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

Поддерживает ли Google Кошелек геозоны?

Да, это поддерживается. Подробную информацию вы найдете в разделе Триггеры push-уведомлений для соответствующего типа карты.

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

Подробнее о том, как настроить программу лояльности…

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

Чтобы отправить логотип на проверку, заполните эту форму.

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

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

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

О том, как создать аккаунт эмитента с помощью API, рассказывается в этом руководстве.

интеллектуальная бесконтактная технология

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

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

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

Чтобы включить эту функцию, выполните настройку.

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

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

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

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

Устранение неполадок

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

Время на карте указывается по часовому поясу места проведения мероприятия.

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

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

Какие заголовки User-Agent использует Google Кошелек для обратных вызовов?

При выполнении запросов обратного вызова сервер Google Кошелька использует заголовки User-Agent Googlebot и Google-Valuables. Партнерам следует добавить эти шаблоны в белые списки в своих сетях доставки контента или брандмауэрах, чтобы запросы не блокировались как боты.

Поддержка и отзывы

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

Если вам нужна дополнительная помощь, обратитесь в службу поддержки. Для этого нажмите кнопку "Связаться со службой поддержки" на боковой панели слева в Google Pay and Wallet Console.

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

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

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

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