本文提供 Google Play Developer API 的版本資訊。
2026 年 11 月 19 日
新功能
續訂優惠:您現在可以建立續訂優惠,當符合資格的訂閱者嘗試取消訂閱時,Google Play 就會顯示這類優惠。
- 保留指定目標:如要使用
monetization.subscriptions.basePlans.offers.create、monetization.subscriptions.basePlans.offers.patch或monetization.subscriptions.basePlans.offers.batchUpdate方法建立或更新保留優惠,請將優惠targeting欄位中的retentionRule設為RetentionTargetingRule物件。使用scope、minDuration、allowMultipleClaims和minOfferCooldownDuration欄位,定義哪些訂閱者符合資格,以及他們是否可以多次領取優惠。 - 優惠播映時段:
SubscriptionOffer資源現在包含選用的startTime和endTime欄位,可設定優惠 (例如續訂優惠) 的提供時間和停止提供時間。 - 指定使用者:如要只向特定訂閱者提供續訂優惠,請在優惠的
targeting欄位中設定retentionPerUserRule(RetentionPerUserTargetingRule)。如要將優惠指定給訂閱項目,請使用purchaseToken和offerId呼叫purchases.subscriptionsv2.activateOfferTargeting方法。如要移除指定目標,請呼叫purchases.subscriptionsv2.deactivateOfferTargeting方法。SubscriptionPurchaseV2 資源會列出developerTargetedOffers欄位中每個委刊項指定的優惠,包括每項優惠的offerId和activateTime。 - 方案轉換通知:訂閱者接受續訂優惠時,系統會傳送新的訂閱 RTDN 類型
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21)。 - 方案轉換詳細資料:SubscriptionPurchaseV2 資源現在包含
autoRenewingPlan中的planTransitionDetails物件。它會識別offerId中接受的續訂優惠,並在transitionInfo中回報轉換狀態。
- 保留指定目標:如要使用
取消和撤銷訂閱項目的 ETag 驗證:
purchases.subscriptionsv2.cancel和purchases.subscriptionsv2.revoke方法現在支援CancellationContext和RevocationContext中的選用etag欄位。當多個要求同時修改同一個訂閱項目時,請使用etag欄位來避免衝突。從最近一次purchases.subscriptionsv2.get呼叫傳回的頂層etag欄位中,取得etag值。
2026 年 7 月 6 日
新功能
交易退單費用責任更新:Google Play 現已支援協作交易退單爭議流程。
待審核退款通知:使用者要求交易退單時,系統會傳送新的即時開發人員通知 (RTDN) 類型
PendingRefundReviewNotification,待處理的評論僅支援「CHARGEBACK」做為退款原因。ReviewRefund API:您可以呼叫新的
orders.reviewrefundAPI,在 24 小時內評估並回覆這些要求。在 API 呼叫中,您必須提供退款偏好設定 (例如APPROVE、DECLINE或NEUTRAL) 和任何相關的購買使用證據 (例如使用者 IP 位址、累計消費百分比和粗略地理位置),協助 Google Play 爭議交易退單。
2026 年 5 月 19 日
新功能
- 待處理訂單 ID:SubscriptionPurchaseV2 API 現在包含
onHoldStateContext和inGracePeriodStateContext欄位。當訂閱項目因續訂付款遭拒而進入ON_HOLD或IN_GRACE_PERIOD狀態時,這些欄位會提供其他詳細資料,例如待處理或失敗的訂單 ID。
淘汰項目
- 部分訂閱 API 已淘汰。詳情請參閱「2026 年 5 月淘汰 Subscription API」。
2026 年 1 月 27 日
新功能
延後訂閱項目和加購內容:先前 Google Play Developer API 僅允許延後單一訂閱項目的帳單。現在,您可以透過
purchases.subscriptionsv2.defer方法,對單一訂閱項目和含有加購項目的訂閱項目使用延期功能。如果延後含有加購內容的訂閱項目帳單結算日,訂閱項目中所有項目的帳單結算日都會延後指定時間。OfferPhase:SubscriptionPurchaseV2 API 現在提供
OfferPhase欄位。這個欄位會提供訂閱項目的目前優惠階段,包括按比例計算期、免費試用期、新用戶優惠和基本方案價格。
2025 年 11 月 19 日
新功能
-
outOfAppPurchaseContext欄位現已在 SubscriptionPurchaseV2 中提供,可提供過期訂閱項目的詳細資料,協助連結在 Play 商店中重新訂閱的購買交易。- purchases.subscriptions.acknowledge 方法現在接受要求主體中的選用
externalAccountId,可讓您將重新訂閱購買交易與使用者 ID 建立關聯。
SubscriptionPurchaseV2 現在提供
SubscriptionPurchaseLineItem.itemReplacement欄位,可提供所更換項目的詳細資料 (如適用)。Orders API 現在包含
offerPhaseDetails欄位,可提供按比例計算期間訂單資金的詳細資訊。
2025 年 9 月 11 日
新功能
SubscriptionPurchaseV2 API 現在提供
cancel方法。這個方法在用戶端程式庫中導入對
cancellationType參數的支援,強化現有的 purchases.subscriptions.cancel 功能。價格調漲同意功能適用於:
SubscriptionPurchaseV2 中新增了
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details欄位。我們推出新的即時開發人員通知類型:SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED。
2025 年 6 月 30 日
新功能
- 新的 ProductPurchaseV2 API 支援單次產品的多種購買選項和優惠。
2025 年 5 月 21 日
淘汰項目
- 部分訂閱 API 已淘汰。詳情請參閱「Subscription API 淘汰」。
新功能
SubscriptionPurchaseV2 提供下列新欄位:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
subscriptionsv2.revoke方法現在提供item_based_refund選項。
其他變更
- purchases.subscriptions API 中的 subscriptionId 參數為選用。