本文列出處於淘汰期的 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.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。