Прежде чем начать выполнять вызовы API, необходимо настроить доступ к API для вашего аккаунта разработчика Google Play. Это потребует внесения изменений как в Google Play Console, так и в Google Cloud Console. Ниже приведены инструкции, необходимые для начала использования API разработчика Google Play.
- Создайте проект Google Cloud.
- Включите API разработчика Google Play для вашего проекта Google Cloud.
- Настройте учетную запись службы с соответствующими разрешениями Google Play Console для доступа к API разработчика Google Play.
Создайте проект Google Cloud
Вы можете пропустить этот шаг, если у вас уже есть проект Google Cloud, который вы хотите использовать.
Создайте проект в Google Cloud Console .
Дополнительную информацию о проектах Google Cloud см. в разделе Создание и управление проектами .
Включить API
После настройки проекта Google Cloud вам необходимо включить API разработчика Google Play для этого проекта.
Чтобы включить API разработчика Google Play:
- Перейдите на страницу API разработчика Google Play в Google Cloud Console.
- Нажмите «Включить» .
Настройка OAuth и учетных записей служб
Вам необходимо настроить доступ к API разработчика Google Play с помощью OAuth-клиента или сервисной учётной записи. В большинстве случаев для доступа к API следует использовать сервисную учётную запись.
Учётные записи служб должны использоваться в безопасной среде, например, на вашем сервере. Учётные данные учётных записей служб должны управляться безопасно, чтобы они не были раскрыты лицам, не имеющим полномочий использовать API.
Идентификатор клиента OAuth следует использовать, если вам требуется доступ к API от имени отдельного пользователя. Например, если вашему веб-сайту требуется доступ к API разработчика Google Play из веб-клиента от имени пользователя, вы можете использовать идентификатор клиента. Пользователь будет аутентифицирован с помощью своего аккаунта Google, а не сервисного аккаунта. Это позволит вам совершать вызовы API от имени пользователя, не раскрывая данные сервисного аккаунта.
- Учетная запись сервиса: защищенная программная служба будет получать доступ к API (наиболее распространенный вариант)
- Клиенты OAuth: пользователь получит доступ к API
Использовать учетную запись службы
Вы можете создать учетную запись сервиса из Google Play Console.
- В консоли Google Cloud перейдите в раздел «Учетные записи служб» .
- Нажмите «Создать учетную запись службы» и следуйте инструкциям.
- Перейдите на страницу «Пользователи и разрешения» в консоли Google Play.
- Нажмите Пригласить новых пользователей .
В поле адреса электронной почты введите адрес вашей учетной записи службы и предоставьте необходимые права для выполнения действий.
Для использования API Google Play Billing необходимо предоставить следующие разрешения:
- Просмотр финансовых данных, заказов и ответов на опрос об отмене заказов
- Управление заказами и подписками
Нажмите Пригласить пользователя .
На этом этапе у вас должен быть доступ к API разработчика Google Play через учётную запись сервиса. Подробнее см. в статье «Использование OAuth 2.0 для межсерверных приложений» .
Используйте OAuth-клиенты
Вы можете разрешить пользователям выполнять действия через API под своими учётными данными, используя клиент OAuth . Действия пользователя ограничены теми, которые разрешены на странице «Пользователи и разрешения» в Google Play Console.
Перед созданием клиентов OAuth необходимо настроить информацию о бренде вашего продукта. Подробнее см. в разделе «Настройка экрана согласия OAuth» .
- В консоли Google Cloud перейдите на страницу экрана согласия OAuth .
- Следуйте инструкциям по созданию экрана согласия OAuth.
Чтобы создать OAuth-клиент:
- В консоли Google Cloud перейдите в раздел Учетные данные .
- Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».
- Выберите тип заявки и следуйте инструкциям.
Дополнительная информация
Воспользуйтесь следующими советами и приемами, которые помогут вам начать использовать API в Google Play.
Получите свой идентификатор разработчика
Для некоторых API требуется указать идентификатор разработчика Google Play Console. Это длинный номер, который присваивается при создании вашего аккаунта разработчика Google Play. Ваш идентификатор разработчика можно найти в URL-адресе практически любой страницы Google Play Console, например, страницы доступа к API .
Например, рассмотрим URL-адрес Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
В указанном выше URL-адресе идентификатор разработчика будет 1234567890123456789 .
Примечание: При переносе приложения из одного аккаунта разработчика Google Play в другой идентификатор разработчика, связанный с этим приложением, изменится. Это означает, что после завершения переноса в вызовах API для этого приложения необходимо использовать идентификатор разработчика нового аккаунта разработчика Google Play.
Специализированные API
API разработчика Google Play содержит несколько специализированных API, которые позволяют выполнять определенные типы анализа вашего приложения:
- API ответов на отзывы
- Позволяет просматривать отзывы пользователей о вашем приложении и отвечать на эти отзывы.
- API аннулированных покупок
- Позволяет отозвать доступ к продуктам в приложении, связанным с покупками, которые пользователь отменил.
Клиентские библиотеки
Мы предоставили клиентские библиотеки, которые можно использовать для программного доступа к REST API. Подробнее см. в разделе «Клиентские библиотеки и примеры кода» .