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

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

Сроки амортизации: с 19 мая 2026 года по 31 августа 2028 года.

Функции и API в этом разделе устарели с 19 мая 2026 года и будут отключены 31 августа 2028 года. Однако вы можете продлить срок поддержки устаревших элементов до 1 ноября 2028 года.

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

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

API Доступна замена
подписки.отменить подпискиv2.отмена
подписки.отложить subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

Сроки амортизации: с 21 мая 2025 года по 31 августа 2027 года.

Функции и API в этом разделе устарели с 21 мая 2025 года и будут отключены 31 августа 2027 года. Однако вы можете продлить срок поддержки устаревших элементов до 1 ноября 2027 года.

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

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

API Доступна замена
подписки.get subscriptionsv2.get
подписки.возврат Вызовите subscriptionsv2.get , чтобы получить SubscriptionPurchaseLineItem.latest_successful_order_id, а затем вызовите Orders.refund , чтобы вернуть деньги за заказы.
подписки.отзыв subscriptionsv2.revoke
SubscriptionPurchaseV2.latestOrderId SubscriptionPurchaseLineItem.latest_successful_order_id
RealTimeDeveloperNotification.SubscriptionNotification.subscriptionId Замена не предусмотрена
RealTimeDeveloperNotification.SubscriptionNotification.notificationTypeSUBSCRIPTION_PRICE_CHANGE_CONFIRMED ИЗМЕНЕНИЕ_ЦЕНЫ_ПОДПИСКИ_ОБНОВЛЕНО

Поля SubscriptionPurchaseV2 для повторяющихся подписок

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

Покупка подписки SubscriptionPurchasV2
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