淘汰項目

本文件列出 Google Play Developer API 和相關功能的淘汰期。

淘汰時間表：2025 年 5 月 21 日至 2027 年 8 月 31 日

本節中的功能和 API 自 2025 年 5 月 21 日起已淘汰，並將於 2027 年 8 月 31 日全面停用。不過，您可以使用已淘汰項目的延長期限，期限至 2027 年 11 月 1 日。

已淘汰的訂閱 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

週期或經常性訂閱項目的 PurchasePurchaseV2 欄位

purchases.subscriptionv2 包含新欄位，可提供新訂閱物件的詳細資訊。下表顯示舊版訂閱項目端點的欄位如何對應至 purchases.subscriptionv2 中的對應欄位。

訂閱購買 訂閱購買第 2 版
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 找到這項資訊。
developerPayload (無對等欄位) 開發人員酬載已淘汰
paymentState (無對等欄位)
您可以從 subscriptionState 推測付款狀態：
  • 付款處理中：
    • SUBSCRIPTION_STATE_PENDING (有待處理交易的新交易)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • 已收到付款：
    • SUBSCRIPTION_STATE_ACTIVE
  • 免費試用：
    • Order.line_items.subscription_details.offer_phase 欄位，可透過 Orders.get API 擷取。
  • 延遲升級/降級：
    • SUBSCRIPTION_STATE_PENDING
cancelReason、userCancellationTimeMillis、cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (不變)
purchaseType 測試：透過 testPurchase
Promotion：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。