Google Play Developer API 版本資訊

本文提供 Google Play Developer API 的版本資訊。

2026 年 1 月 27 日

新功能

• 含加購內容的訂閱項目延期：先前，Google Play Developer API 僅允許延後單一訂閱項目的帳單日期。現在，單一訂閱方案和含加購內容的訂閱方案都可透過 purchases.subscriptionsv2.defer 方法延期。延後含有加購內容的訂閱項目帳單結算日後，訂閱項目中所有項目的帳單結算日都會延後指定時間。

• OfferPhase：OfferPhase 欄位現已在 SubscriptionPurchaseV2 API 中提供。這個欄位會提供訂閱項目的目前優惠階段，包括按比例計算的週期、免費試用期、新用戶優惠和基本方案價格。

2025 年 11 月 19 日

新功能

• 加強處理重新訂閱作業。

  • SubscriptionPurchaseV2 現在提供 outOfAppPurchaseContext 欄位，可提供已到期訂閱項目的詳細資料，協助連結透過 Play 商店進行的續訂交易。
  • purchases.subscriptions.acknowledge 方法現在接受要求主體中的選用 externalAccountId，可讓您將續訂購買交易與使用者 ID 建立關聯。

• SubscriptionPurchaseLineItem.itemReplacement 欄位現已在 SubscriptionPurchaseV2 中提供，可視情況提供要更換的項目詳細資料。

• 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_id
  • PriceChangeState.CANCELED

• subscriptionsv2.revoke 方法現在提供 item_based_refund 選項。

• Orders API 現在提供 get 和 batchGet 方法。

其他變更

• 在 purchases.subscriptions API 中，subscriptionId 參數為選用。