Примечания к выпуску Google Play Developer API

В этом документе содержатся примечания к выпуску Google Play Developer API.

6 июля 2026 г.

Новые функции

  • Обновления в распределении расходов по чарджбэкам. Теперь в Google Play поддерживается совместный процесс оспаривания чарджбэков.

    • Уведомления о запросах на возврат средств, ожидающих рассмотрения. Новый тип уведомлений для разработчиков в режиме реального времени (RTDN) – PendingRefundReviewNotification – отправляется, когда пользователь запрашивает чарджбэк, требующий вашего рассмотрения. Для ожидающих рассмотрения запросов на возврат средств поддерживается только причина CHARGEBACK.

    • ReviewRefund API. Вы можете оценивать запросы и отвечать на них в течение 24 часов, используя новый API orders.reviewrefund. В вызове API необходимо указать предпочтительный способ возврата средств (например, APPROVE, DECLINE или NEUTRAL) и предоставить доказательства использования покупки (например, IP-адрес пользователя, процент использования и приблизительное географическое местоположение), чтобы помочь Google Play оспорить возвратный платеж.

19 мая 2026 г.

Новые функции

  • Идентификатор заказа, ожидающего обработки. В API SubscriptionPurchaseV2 теперь есть поля onHoldStateContext и inGracePeriodStateContext. Эти поля содержат дополнительные сведения, например идентификатор ожидающего или отклоненного заказа, когда подписка переходит в состояние ON_HOLD или IN_GRACE_PERIOD из-за отклоненного платежа за продление.

Deprecations

27 января 2026 г.

Новые функции

  • Отсрочка платежей за подписки с дополнениями. Ранее Google Play Developer API позволял откладывать платежи только за отдельные подписки. Теперь отсрочка доступна как для отдельных подписок, так и для подписок с дополнениями. Для этого используется метод purchases.subscriptionsv2.defer. Если вы отложите дату выставления счета для подписки с дополнениями, дата выставления счета для всех элементов в подписке будет отложена на указанный срок.

  • OfferPhase. Поле OfferPhase теперь доступно в API SubscriptionPurchaseV2. Это поле содержит текущий этап предложения подписки, например пропорциональный период, бесплатный пробный период, начальная цена и цена основного плана.

19 ноября 2025 г.

Новые функции

  • Улучшенная обработка повторных подписок.

    • Поле outOfAppPurchaseContext теперь доступно в SubscriptionPurchaseV2. Оно помогает связывать покупки, сделанные при повторном оформлении подписки в Google Play, с данными об истекшей подписке.
    • Метод purchases.subscriptions.acknowledge теперь принимает необязательный параметр externalAccountId в теле запроса, что позволяет связать повторную подписку с идентификаторами пользователей.

  • В SubscriptionPurchaseV2 теперь доступно поле SubscriptionPurchaseLineItem.itemReplacement, в котором при необходимости можно указать сведения о заменяемом объекте.

  • В Orders API теперь есть поле offerPhaseDetails, в котором содержится более подробная информация о заказах, финансирующих пропорциональный период.

11 сентября 2025 г.

Новые функции

30 июня 2025 г.

Новые функции

21 мая 2025 г.

Deprecations

Новые функции

  • В SubscriptionPurchaseV2 доступны следующие новые поля:

    • SubscriptionPurchaseLineItem.latest_successful_order_id
    • PriceChangeState.CANCELED

  • Метод subscriptionsv2.revoke теперь поддерживает параметр item_based_refund.

  • В Orders API теперь доступны методы get и batchGet.

Другие изменения