지원 중단

이 문서에는 지원 중단 기간에 있는 Google Play Developer API 및 관련 기능이 나열되어 있습니다.

지원 중단 일정 - 2026년 5월 19일~2028년 8월 31일

이 섹션의 기능과 API는 2026년 5월 19일에 지원 중단되며 2028년 8월 31일에 종료됩니다. 하지만 지원 중단된 항목에 대해 2028년 11월 1일까지 연장을 이용할 수 있습니다.

지원 중단된 Subscription API

이 섹션에는 지원 중단된 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일까지 연장을 이용할 수 있습니다.

지원 중단된 Subscription API

이 섹션에는 지원 중단된 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 대체 API 없음
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
priceCurrenceCode, priceAmountMicros 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
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