Google Play Developer API 출시 노트

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

2026년 1월 27일

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

재구독 처리 개선
- 이제 outOfAppPurchaseContext 필드를 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이 필드는 만료된 정기 결제의 세부정보를 제공하여 Play 스토어에서 이루어진 재구독 구매를 연결하는 데 도움이 됩니다.
- 이제 purchases.subscriptions.acknowledge 메서드는 요청 본문에서 선택적 externalAccountId를 허용하므로 재구독 구매를 사용자 식별자와 연결할 수 있습니다.
이제 SubscriptionPurchaseLineItem.itemReplacement 필드를 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이 필드는 교체되는 항목에 관한 세부정보를 제공합니다(해당하는 경우).
이제 주문 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 메서드를 제공합니다.