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

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

19 ноября 2026 г.

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

  • Специальные предложения. Теперь вы можете создавать специальные предложения, которые Google Play будет показывать подписчикам, когда они попытаются отменить подписку.

    • Таргетинг на удержание. Чтобы создать или обновить специальное предложение по удержанию с помощью метода monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch или monetization.subscriptions.basePlans.offers.batchUpdate, задайте для поля retentionRule в объекте targeting значение RetentionTargetingRule. Используйте поля scope, minDuration, allowMultipleClaims и minOfferCooldownDuration, чтобы определить, какие подписчики могут воспользоваться предложением и сколько раз.
    • Период доступности специального предложения. В ресурс SubscriptionOffer добавлены необязательные поля startTime и endTime, которые позволяют указать, когда специальное предложение, например для удержания пользователей, становится доступным и когда оно перестает действовать.
    • Таргетинг на отдельных пользователей. Чтобы сделать предложение по удержанию доступным только определенным подписчикам, задайте значение retentionPerUserRule (RetentionPerUserTargetingRule) в поле targeting. Чтобы настроить таргетинг специального предложения на подписку, вызовите метод purchases.subscriptionsv2.activateOfferTargeting с параметрами purchaseToken и offerId. Чтобы удалить таргетинг, вызовите метод purchases.subscriptionsv2.deactivateOfferTargeting. Ресурс SubscriptionPurchaseV2 содержит список специальных предложений, связанных с каждой позицией в поле developerTargetedOffers, включая offerId и activateTime каждого предложения.
    • Уведомления о переходе на другой план. Новый тип уведомлений для разработчиков в режиме реального времени – SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21). Они отправляются, когда подписчик принимает предложение по удержанию.
    • Сведения о переходе на другой план. Ресурс SubscriptionPurchaseV2 теперь включает объект planTransitionDetails в autoRenewingPlan. Оно определяет принятое предложение по удержанию в offerId и сообщает о состоянии перехода в transitionInfo.
  • Проверка ETag при отмене и отзыве подписки. Методы purchases.subscriptionsv2.cancel и purchases.subscriptionsv2.revoke теперь поддерживают необязательное поле etag в CancellationContext и RevocationContext. Используйте поле etag, чтобы предотвратить конфликты, когда несколько запросов одновременно изменяют одну и ту же подписку. Получите значение etag из поля etag верхнего уровня, возвращенного последним вызовом purchases.subscriptionsv2.get.

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.

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