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

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

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

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

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

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

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

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

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

ПодпискаКупить ПодпискаПокупкаV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(нет эквивалентного поля) lineItems (список SubscriptionPurchaseLineItem), представляющий продукты, приобретенные при покупке
(нет эквивалентного поля) lineItems.offerDetails.basePlanId
(нет эквивалентного поля) lineItems.offerDetails.offerId
(нет эквивалентного поля) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (каждая подписка, приобретенная при покупке, имеет свой expiryTime )
(нет эквивалентного поля) subscriptionState (указывает состояние подписки)
(нет эквивалентного поля) pausedStateContext (присутствует только если статус подписки — SUBSCRIPTION_STATE_PAUSED )
autoResumeTimeMillis pausedStateContext.autoResumeTime
(нет эквивалентного поля) canceledStateContext (присутствует только если статус подписки — SUBSCRIPTION_STATE_CANCELED )
(нет эквивалентного поля) testPurchase (присутствует только в покупках лицензированных тестировщиков)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode , priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (нет эквивалентного поля)
Эту информацию можно найти в offer по каждой из приобретенных подписок.
разработчикПолезная нагрузка (нет эквивалентного поля) полезная нагрузка разработчика устарела
платежState (нет эквивалентного поля)
Вы можете определить состояние платежа из subscriptionState :
  • Ожидается оплата:
    • SUBSCRIPTION_STATE_PENDING (новые покупки с ожидающей транзакцией)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Платеж получен:
    • SUBSCRIPTION_STATE_ACTIVE
  • Бесплатная пробная версия:
    • Поле Order.line_items.subscription_details.offer_phase, которое можно получить с помощью API Orders.get.
  • Отложенное повышение/понижение рейтинга:
    • SUBSCRIPTION_STATE_PENDING
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

Другие функции управления подпиской

Хотя purchases.subscriptions:get был обновлен до purchases.subscriptionsv2:get , остальные функции управления подписками разработчика на данный момент остаются неизменными в конечной точке purchases.subscriptions , поэтому вы можете продолжать использовать purchases.subscriptions:acknowledge , purchases.subscriptions:cancel , purchases.subscriptions:defer , purchases.subscriptions:refund и purchases.subscriptions:revoke как и раньше.