이 문서에는 지원 중단 기간에 있는 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 |
반복 정기 결제의 SubscriptionPurchaseV2 필드
purchases.subscriptionv2에는 새 정기 결제 객체에 관한 세부정보를 제공하는 새 필드가 포함되어 있습니다. 다음 표는 기존 정기 결제 엔드포인트의 필드가 purchases.subscriptionv2의 상응하는 필드에 매핑되는 방식을 보여줍니다.
| SubscriptionPurchase | SubscriptionPurchaseV2 |
|---|---|
countryCode |
regionCode |
orderId |
SubscriptionPurchaseLineItem.latest_successful_order_id |
| (상응하는 필드가 없음) | 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 |
(상응하는 필드가 없음) 이 정보는 구매한 각 정기 결제의 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를 전처럼 계속 사용할 수 있습니다.