Руководство по началу работы с API Android для Google Pay API for Passes

Используя интерфейс API Android для Google Pay API for Passes, пользователи могут сохранять объекты со значениями в Google Pay одним нажатием кнопки. В этом руководстве по началу работы представлены простые настройки для сохранения объектов карт постоянного клиента, подарочных карт и специальных предложений.

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

Шаг 1. Соберите приложение для Android

Тестовое приложение – это проект с открытым исходным кодом, предназначенный для быстрого начала работы, который можно скачать с ресурса GitHub. Для этого выполните следующие действия:

  1. Зайдите в хранилище GitHub.
  2. Скачайте ZIP-файл с проектом или клонируйте хранилище с помощью команды git clone https://github.com/google-pay/s2gp-quickstart-android.

Образец приложения можно открыть в Android Studio как существующий проект. Возможно, для правильной компиляции понадобится синхронизировать проект. Как только вы соберете образец приложения в Android Studio, его можно запустить на устройстве или эмуляторе Android.

Шаг 2. Создайте класс

Класс можно создать в сервисе Google Pay API for Passes Merchant Center. Для этого откройте страницу "Классы" и выберите "Создать класс". Обязательными для заполнения являются только поля, обведенные красным. Если в поле нужно ввести URL-адрес, убедитесь, что соответствующая страница находится в открытом доступе. На класс будет ссылаться объект со значениями, когда вы его создадите.

Шаг 3. Настройте приложение для Android

Чтобы образец приложения работал правильно, нужно изменить некоторые значения. В файле strings.xml, найденном в app/res/values/, выполните следующие действия:

  1. Замените значение ISSUER_ID вашим идентификатором продавца Issuer ID для Google Pay API for Passes.
  2. Замените значение LOYALTY_CLASS_ID, GIFTCARD_CLASS_ID или OFFER_CLASS_ID названием соответствующего класса, созданного ранее в Google Pay API for Passes Merchant Center.

В MainActivity.java определенные значения для каждого объекта нужно задавать так, чтобы они соответствовали классу, на который ссылаются объекты в Merchant Center.

  1. Для объекта GiftCardWalletObject в методе generateGiftCardWalletObject значения setIssuerName и setTitle должны совпадать со значениями в классе.
  2. Для объекта LoyaltyWalletObject в методе generateLoyaltyWalletObject значения setIssuerName и setProgramName должны совпадать со значениями в классе.
  3. Для объекта OfferWalletObject в методе generateLoyaltyWalletObject значения setIssuerName и setTitle должны совпадать со значениями в классе.

Шаг 4. Протестируйте приложение для Android

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