Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Google Play Developer API 출시 노트

이 문서에는 Google Play Developer API 출시 노트가 포함되어 있습니다.

2026년 5월 19일

보류 중인 주문 ID: 이제 SubscriptionPurchaseV2 API에 onHoldStateContext 및 inGracePeriodStateContext 필드가 포함됩니다. 이러한 필드는 갱신 결제가 거부되어 정기 결제가 ON_HOLD 또는 IN_GRACE_PERIOD 상태로 전환될 때 보류 중이거나 실패한 주문 ID와 같은 추가 세부정보를 제공합니다.

부가기능이 포함된 정기 결제 연기: 이전에는 Google Play Developer API에서 단일 정기 결제에 대해서만 결제 연기가 허용되었습니다. 이제 purchases.subscriptionsv2.defer 메서드를 통해 단일 정기 결제 와 부가기능이 포함된 정기 결제 모두에 연기 기능을 사용할 수 있습니다. 부가기능이 포함된 정기 결제의 결제일을 연기하면 정기 결제의 모든 항목에 대한 결제일이 지정된 기간만큼 연기됩니다.
OfferPhase: 이제 SubscriptionPurchaseV2 API에서 OfferPhase 필드를 사용할 수 있습니다. 이 필드는 정기 결제의 현재 혜택 단계를 일할 계산 기간, 무료 체험판, 신규 할인 가격, 기본 요금제 가격 중 하나로 제공합니다.

재구독 처리 개선.
- 이제outOfAppPurchaseContext 필드를 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이 필드는 만료된 정기 결제에서 세부정보를 제공하여 Play 스토어에서 이루어진 재구독 구매를 연결하는 데 도움이 됩니다.
- 이제 purchases.subscriptions.acknowledge 메서드가 요청 본문에서 선택적 externalAccountId를 허용하므로 재구독 구매를 사용자 식별자와 연결할 수 있습니다.
SubscriptionPurchaseLineItem.itemReplacement 필드를 이제 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이 필드는 교체되는 항목에 관한 세부정보를 제공합니다(해당하는 경우).
이제 Orders API에 offerPhaseDetails 필드가 포함됩니다. 이 필드는 일할 계산 기간에 자금을 지원하는 주문에 관한 자세한 정보를 제공합니다.

이제 SubscriptionPurchaseV2 API에서 cancel 메서드를 제공합니다.

이 메서드는 클라이언트 라이브러리에서 cancellationType 매개변수 지원을 도입하여 기존 purchases.subscriptions.cancel 기능을 개선합니다.
가격 인상 동의 기능을 사용할 수 있습니다.
- SubscriptionPurchaseV2에 새 필드 SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details가 추가되었습니다.
- 새로운 실시간 개발자 알림 유형 SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED을 사용할 수 있습니다.

SubscriptionPurchaseV2에서 다음과 같은 새 필드를 사용할 수 있습니다.
- SubscriptionPurchaseLineItem.latest_successful_order_id
- PriceChangeState.CANCELED
이제 subscriptionsv2.revoke 메서드에서 item_based_refund 옵션을 제공합니다.
이제 Orders API에서 get 및 batchGet 메서드를 제공합니다.