В этом документе перечислены API для разработчиков Google Play и связанные с ними функции, которые находятся в периоде устаревания.
Сроки амортизации: с 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 | SubscriptionPurchaseLineItem.latest_successful_order_id |
| (Нет эквивалентного поля) | lineItems.offerPhase (определяет текущий этап: бесплатный пробный период, вводная цена, пропорциональное распределение, базовая цена) |
| (Нет эквивалентного поля) | 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 | lineItems.offerPhase.introductoryPriceЭту информацию также можно найти в offer к каждой из приобретенных подписок. |
| developerPayload | (Нет эквивалентного поля) полезная нагрузка разработчика устарела |
| paymentState | (Нет эквивалентного поля) Состояние платежа можно определить по subscriptionState :
|
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 как и раньше.