非推奨のサービスと機能

このドキュメントでは、非推奨期間中の Google Play Developer API と関連機能の一覧を示します。

サポート終了のスケジュール - 2026 年 5 月 19 日~ 2028 年 8 月 31 日

このセクションの機能と API は 2026 年 5 月 19 日をもって非推奨となり、2028 年 8 月 31 日にシャットダウンされます。ただし、非推奨のアイテムについては、2028 年 11 月 1 日まで延長できます。

非推奨のサブスクリプション API

このセクションでは、API の非推奨について説明します。

API 交換用デバイス
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

非推奨のスケジュール - 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

SubscriptionPurchaseV2 フィールド(定期購入の場合)

purchases.subscriptionv2 には、新しい定期購入オブジェクトに関する詳細情報を提供する新しいフィールドが含まれています。従来の定期購入エンドポイントのフィールドが、purchases.subscriptionv2 の対応するフィールドにどのようにマッピングされているかを次の表に示します。

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
保留中の注文 ID は、inGracePeriodStateContext.renewalDeclined.pendingOrderId または onHoldStateContext.renewalDeclined.pendingOrderId から取得できます。
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime(購入により獲得された定期購入にはそれぞれ固有の expiryTime があります)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCodepriceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
この情報は、購入された各定期購入の offer でも確認できます。
developerPayload (対応するフィールドなし)デベロッパー ペイロードは非推奨になりました
paymentState (対応するフィールドなし)
支払いステータスは次のように subscriptionState から推測できます。
  • 支払いが保留中:
    • SUBSCRIPTION_STATE_PENDING(保留中の取引における新規購入)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • 支払いが受領済み:
    • SUBSCRIPTION_STATE_ACTIVE
  • 無料試用:
    • lineItems.offerPhase.freeTrial
  • アップグレード / ダウングレードが延期された:
    • lineItems.deferredItemReplacement
cancelReasonuserCancellationTimeMilliscancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken(変更なし)
purchaseType テスト: testPurchase
プロモーション: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileNameemailAddressgivenNamefamilyNameprofileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionTypepromotionCode signupPromotion
externalAccountIdobfuscatedExternalAccountIdobfuscatedExteranlProfileId externalAccountIdentifiers