Google Play Developer API

Обзор

Google Play Console предоставляет набор API веб-сервисов на основе REST, которые позволяют публиковать приложения, создавать отчеты и выполнять другие действия по управлению приложениями.

Эти 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-вызовы, чтобы программно управлять метаданными, которые лежат в основе функций сервисов Play Games.
  • Voided Purchases API предоставляет список заказов, связанных с аннулированными покупками.

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

Чтобы начать работу с Google Play Developer API, ознакомьтесь с документацией.

API для публикации

Publishing 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 к Google.
  • Ваш защищенный сервер должен использовать Google Play Developer API для получения информации о подписках в двух случаях:
    • Ваш сервер получает новый токен покупки, который ранее не использовался.
    • Ваш сервер получает уведомление для разработчиков в режиме реального времени (RTDN), которое указывает, что вам нужно использовать токен покупки, чтобы получить новую информацию о подписке.
  • Не запрашивайте статус подписки через API на регулярной основе. Например, не вызывайте API ежедневно, чтобы проверить каждую подписку.
  • Поскольку вы получаете RTDN, когда подписка продлевается или истекает, вам не нужно планировать вызов API на основе запланированного срока действия.

Reporting API

Reporting API предназначен для разработчиков, которые хотят создавать автоматизированные рабочие процессы на основе данных Play Console или использовать эти данные для внутренней бизнес-отчетности и анализа, возможно, вместе с другими наборами данных. Он предоставляет программный доступ к данным и показателям приложения. Используя их, вы сможете создавать внутренние отчеты, выполнять анализ и автоматизировать процессы.

Reporting API предоставляет доступ к данным Android Vitals, включая долю сбоев, долю ошибок ANR, проблемы с пробуждением и запретом блокировки, а также трассировки стека ошибок.

Рекомендации

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, вы помогаете создать более сбалансированную и справедливую среду для всех пользователей вашего приложения, особенно если это игра.