Прекращение поддержки

В этом документе перечислены Google Play Developer API и связанные с ними функции, поддержка которых прекращена.

Сроки прекращения поддержки: с 19 мая 2026 г. по 31 августа 2028 г.

Поддержка функций и API, перечисленных в этом разделе, будет прекращена 19 мая 2026 года, а 31 августа 2028 года они будут отключены. Для устаревших объектов вы можете запросить продление до 1 ноября 2028 года, отправив запрос в службу поддержки через Play Console > Справка.

Устаревшие API для подписок

В этом разделе перечислены устаревшие API.

API Доступная замена
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

Сроки прекращения поддержки – с 21 мая 2025 г. по 31 августа 2027 г.

Поддержка функций и API, перечисленных в этом разделе, прекращается 21 мая 2025 г. Они будут отключены 31 августа 2027 г. Для устаревших элементов вы можете запросить продление до 1 ноября 2027 года, отправив запрос в службу поддержки через Play Console > Справка.

Устаревшие API для подписок

В этом разделе перечислены устаревшие API.

API Доступная замена
subscriptions.get subscriptionsv2.get
subscriptions.refund Вызовите метод subscriptionsv2.get, чтобы получить SubscriptionPurchaseLineItem. latest_successful_order_id, а затем вызовите Orders.refund, чтобы вернуть средства за заказы.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Без замены
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Поля SubscriptionPurchaseV2 для подписок с автоматическим продлением

purchases.subscriptionv2 содержит новые поля, в которых приводится более подробная информация о новых объектах подписки. В таблице ниже показано, как поля из устаревшей конечной точки подписки сопоставляются с соответствующими полями в purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
Идентификатор ожидающего заказа можно получить из inGracePeriodStateContext.renewalDeclined.pendingOrderId или onHoldStateContext.renewalDeclined.pendingOrderId.
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (у каждой подписки, приобретенной в рамках покупки, есть собственный идентификатор expiryTime)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
Эту информацию также можно найти в offer для каждой приобретенной подписки.
developerPayload (эквивалентное поле отсутствует, так как полезная нагрузка разработчика больше не поддерживается)
paymentState (эквивалентное поле отсутствует)
Статус платежа можно определить по значению поля subscriptionState:
  • Платеж обрабатывается:
    • SUBSCRIPTION_STATE_PENDING (новые покупки с транзакцией в обработке)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Платеж получен:
    • SUBSCRIPTION_STATE_ACTIVE
  • Бесплатный пробный период:
    • lineItems.offerPhase.freeTrial
  • Отложенный переход на более дорогую или дешевую версию:
    • lineItems.deferredItemReplacement
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (без изменений)
purchaseType Тестирование: до testPurchase
Продвижение: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers