В этом документе содержатся примечания к выпуску 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
- Некоторые API подписок устарели. Подробнее о прекращении поддержки Subscription API в мае 2026 года…
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 г.
Новые функции
В API SubscriptionPurchaseV2 теперь доступен метод
cancel.Этот метод расширяет возможности существующей функции purchases.subscriptions.cancel, добавляя поддержку параметра
cancellationTypeв клиентских библиотеках.Функции согласия на повышение цены доступны:
В SubscriptionPurchaseV2 добавлено новое поле:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.Добавлен новый тип уведомлений для разработчиков в режиме реального времени – SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.
30 июня 2025 г.
Новые функции
- Доступен новый API ProductPurchaseV2, который поддерживает несколько способов покупки и специальных предложений для контента, оплачиваемого однократно.
21 мая 2025 г.
Deprecations
- Некоторые API подписок устарели. Подробнее о прекращении поддержки Subscription API…
Новые функции
В SubscriptionPurchaseV2 доступны следующие новые поля:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
Метод
subscriptionsv2.revokeтеперь поддерживает параметрitem_based_refund.В Orders API теперь доступны методы
getиbatchGet.
Другие изменения
- Параметр subscriptionId необязателен в API purchases.subscriptions.