Обзор
Google Play Console предоставляет набор веб-сервисов REST API, которые позволяют публиковать приложения, создавать отчеты и выполнять другие задачи по управлению приложениями.
Использовать эти API необязательно. В большинстве случаев вы можете управлять приложениями напрямую в Google Play Console. Однако если вам нужно управлять большим количеством APK или отслеживать покупки и подписки пользователей, эти API могут быть полезны.
Что входит в пакет
Google Play Developer API позволяют сосредоточиться на разработке приложения и тратить меньше времени и усилий на управление выпусками, даже если вы выходите на новые рынки.
В Google Play Console есть набор API, которые можно использовать для управления приложением:
- Publishing API позволяет загружать и публиковать приложения, а также выполнять другие задачи, связанные с публикацией.
- Subscriptions and In-App Purchases API позволяет управлять покупками и подписками в приложении. (ранее – Purchase Status API).
- Reporting API позволяет получать информацию о качестве приложения из Android Vitals.
- Reply to Reviews API позволяет получать отзывы о приложении и отвечать на них.
- Permissions API позволяет автоматизировать управление разрешениями в Play Console.
- Play Games Services Management API позволяет отправлять REST-запросы, чтобы программно управлять метаданными, на которых основаны функции игровых сервисов Google Play.
- Voided Purchases API позволяет получить список заказов, связанных с аннулированными покупками.
Начало работы
Чтобы начать работу с Google Play Developer API, ознакомьтесь с документацией.
API для публикации
Publishing API позволяет автоматизировать типичные задачи, связанные с распространением приложений. Этот API предоставляет функции, аналогичные тем, которые доступны разработчику в Play Console, например:
- Как загрузить новую версию приложения
- Выпуск приложений путем назначения APK-файлов различным типам версий (альфа, бета, поэтапное внедрение или рабочая версия).
- Создание и изменение страниц приложений в Google Play, включая локализованный текст, графические объекты и скриншоты для разных устройств.
Для этого используется функция edits, которая позволяет вносить изменения в рамках транзакций. Это позволяет объединить несколько изменений в один черновик, а затем применить их все сразу. (Изменения вступят в силу только после того, как вы их подтвердите.)
Рекомендации
- Ограничьте количество обновлений приложения. Не публикуйте альфа- и бета-обновления чаще одного раза в день. Рабочие версии приложений следует обновлять ещё реже. Каждое обновление требует от пользователей времени и, возможно, денег. Если вы будете выпускать обновления слишком часто, пользователи могут начать игнорировать их или даже удалить продукт.
Subscriptions and In-App Purchases API
Subscriptions and In-App Purchases API позволяет управлять каталогом контента и подписок в приложении. Кроме того, Subscriptions and In-App Purchases API позволяет быстро получать сведения о любой покупке с помощью стандартного запроса GET.
В запросе вы указываете информацию о покупке: название пакета приложения, идентификатор покупки или подписки и токен покупки. Сервер возвращает объект JSON с информацией о покупке, состоянии заказа, полезной нагрузке разработчика и другими сведениями.
Этот API можно использовать по-разному, например для создания отчетов, сверки отдельных заказов, а также проверки покупок и сроков действия подписок. Кроме того, с помощью API можно получать информацию об отмененных заказах и проверять, был ли использован контент, продаваемый через приложение, в том числе до отмены заказа.
Рекомендации
- Храните информацию о подписках на своем сервере, чтобы избежать лишних вызовов API. Когда приложению нужно проверить подписку, используйте кешированную информацию на сервере, а не повторяйте вызов API к Google.
- Ваш защищенный сервер должен использовать Google Play Developer API для получения информации о подписках в двух случаях:
- Ваш сервер получает новый токен покупки, который ранее не использовался.
- Ваш сервер получает уведомление для разработчиков в режиме реального времени (RTDN), которое указывает, что вам нужно использовать токен покупки, чтобы получить новую информацию о подписке.
- Не отправляйте регулярные запросы к API, чтобы узнать статус подписки. Например, не вызывайте API ежедневно, чтобы проверить каждую подписку.
- Поскольку вы получаете RTDN, когда срок действия подписки истекает или она продлевается, вам не нужно планировать вызов API на основе запланированного срока действия.
Reporting API
Reporting API предназначен для разработчиков, которые хотят автоматизировать рабочие процессы на основе данных Play Console или использовать эти данные для внутренней бизнес-отчетности и анализа, возможно, вместе с другими наборами данных. Он предоставляет программный доступ к данным и показателям приложения. Используя их, вы сможете создавать внутренние отчеты, выполнять анализ и автоматизировать процессы.
Reporting API предоставляет доступ к данным Android Vitals, включая долю сбоев, долю ошибок ANR, проблемы с пробуждением и запретом блокировки, а также трассировки стека ошибок.
Рекомендации
- В этой версии Reporting API по умолчанию установлено ограничение в 10 запросов в секунду. Данные об использовании квоты можно посмотреть в разделе Quotas (Квоты) в консоли Google Cloud. Если вам необходимо превысить это ограничение, отправьте запрос на увеличение квоты, заполнив эту форму.
Reply to Reviews API
Reply to Reviews API позволяет просматривать отзывы пользователей о вашем приложении и отвечать на них. С помощью этого API вы можете взаимодействовать с пользователями напрямую через существующие инструменты поддержки клиентов, например CRM-систему.
Reply to Reviews API позволяет получать отзывы только о рабочих версиях приложения. Чтобы посмотреть отзывы об альфа- и бета-версиях, используйте Google Play Console. Также обратите внимание, что API показывает только отзывы, содержащие комментарии. Если пользователь поставил оценку, но не оставил комментарий, его отзыв будет недоступен через API.
Permissions API
Permissions API позволяет разработчикам автоматизировать управление разрешениями в Play Console. Это позволяет гибко управлять доступом к аккаунту разработчика без ручного вмешательства.
С помощью Permissions API можно выполнять следующие административные функции:
- Закрывать доступ пользователям, которые увольняются из компании.
- Предоставление доступа к приложению, когда пользователь присоединяется к соответствующей команде.
Voided Purchases API
Voided Purchases API позволяет получить список заказов, связанных с аннулированными покупками. Вы можете использовать информацию из этого списка, чтобы реализовать систему отзыва, которая запрещает пользователю доступ к продуктам из этих заказов.
Этот API применяется к однократным заказам в приложении и подпискам на приложения.
Покупка может быть аннулирована следующими способами:
- Пользователь запрашивает возврат средств за заказ.
- Пользователь отменил заказ.
- По заказу выполнен возврат платежа.
- Разработчик отменяет заказ или возвращает средства. Примечание. Voided Purchases API возвращает только аннулированные заказы. Если разработчик возвращает средства, не устанавливая параметр отмены, заказы не будут отображаться в API.
- Google отменяет заказ или возвращает средства.
Используя этот API, вы помогаете создать более сбалансированную и справедливую среду для всех пользователей вашего приложения, особенно если это игра.