Google Кошелек предлагает REST API, который позволяет создавать карты и управлять ими, отправляя запросы к Google Wallet API по протоколу HTTP. Это удобно для тех, кто хочет создавать серверные сервисы для программной работы с картами.
Чтобы использовать Google Кошелек REST API, необходимо включить его в консоли Google Cloud, создать сервисный аккаунт Google Cloud и сгенерировать для него ключ.
При создании карт с помощью REST API ключ сервисного аккаунта используется для подписи объектов карт, закодированных с помощью веб-токена JSON.
Для других операций, таких как обновление или удаление карт, ключ сервисного аккаунта отправляется вместе с запросом на аутентификацию вас как эмитента карт.
1. Как включить Google Кошелек REST API
Чтобы включить Google Кошелек REST API, выполните следующие действия:
- Если у вас нет аккаунта Google Cloud, перейдите в консоль Google Cloud и следуйте инструкциям по регистрации.
- В раскрывающемся меню проектов в верхней части консоли выберите нужный облачный проект Google Cloud или создайте новый.
- Перейдите на страницу Google Wallet API в Google Cloud Marketplace.
- Нажмите кнопку "Включить". Через несколько минут Google Кошелек REST API станет доступен для выбранного облачного проекта Google Cloud.
2. Как создать ключ сервисного аккаунта Google Cloud
Чтобы аутентифицировать запросы к Google Wallet REST API, вам нужно создать сервисный аккаунт и сгенерировать для него ключ. Для этого выполните следующие действия:
- В консоли Google Cloud перейдите на страницу Создание сервисного аккаунта.
- Укажите сведения о сервисном аккаунте. Запишите адрес электронной почты сервисного аккаунта, который указан под полем "Идентификатор сервисного аккаунта". Он понадобится вам позже, когда вы будете использовать сервисный аккаунт для аутентификации запросов к Google Wallet REST API.
- Нажмите кнопку "Готово". Выполнять другие действия по созданию сервисного аккаунта не нужно.
- В верхней части страницы нажмите "Ключи".
- В раскрывающемся меню "Добавить ключ" выберите "Создать ключ".
- Выберите тип ключа JSON.
- Нажмите "Создать", чтобы создать и скачать ключ сервисного аккаунта.
3. Авторизуйте сервисный аккаунт в консоли Google Кошелька
Чтобы аутентифицировать запросы к Google Wallet REST API с помощью ключа сервисного аккаунта, добавьте адрес электронной почты сервисного аккаунта в качестве пользователя в аккаунт эмитента. Чтобы добавить сервисный аккаунт в качестве пользователя, выполните следующие действия:
- Перейдите на страницу Сервисные аккаунты в консоли Google Cloud.
- Скопируйте адрес электронной почты сервисного аккаунта, который вы хотите использовать для аутентификации запросов к Google Wallet API.
- Перейдите в Google Pay & Wallet Console.
- На панели навигации слева нажмите "Пользователи".
- Нажмите "Пригласить пользователя".
- Введите адрес электронной почты сервисного аккаунта.
- В раскрывающемся списке "Уровень доступа" выберите "Разработчик".
- Нажмите кнопку "Пригласить".
После добавления сервисного аккаунта вы можете использовать любые сгенерированные для него ключи, чтобы выполнять аутентификацию запросов к Google Кошелек REST API. При использовании ключей сервисных аккаунтов помните, что это конфиденциальные учетные данные, которые следует использовать только в защищенных серверных средах.