Google Play Developer API 출시 노트

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

2026년 1월 27일

새로운 기능

• 부가기능이 포함된 정기 결제 연기: 이전에는 Google Play Developer API에서 단일 정기 결제에 대해서만 결제 연기가 허용되었습니다. 이제 purchases.subscriptionsv2.defer 메서드를 통해 단일 정기 결제와 부가기능이 있는 정기 결제 모두에 연기 기능을 사용할 수 있습니다. 부가기능이 포함된 정기 결제의 청구일을 연기하면 정기 결제의 모든 항목의 청구일이 지정된 기간만큼 연기됩니다.

• OfferPhase: 이제 OfferPhase 필드를 SubscriptionPurchaseV2 API에서 사용할 수 있습니다. 이 필드는 정기 결제의 현재 혜택 단계를 일할 계산 기간, 무료 체험판, 신규 할인 가격, 기본 요금제 가격 중 하나로 제공합니다.

2025년 11월 19일

새로운 기능

• 재구독 처리 개선

  • 이제 outOfAppPurchaseContext 필드를 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이를 통해 만료된 정기 결제의 세부정보를 제공하여 Play 스토어에서 이루어진 재구독 구매를 연결할 수 있습니다.
  • 이제 purchases.subscriptions.acknowledge 메서드는 요청 본문에서 선택적 externalAccountId를 허용하므로 재구독 구매를 사용자 식별자와 연결할 수 있습니다.

• 이제 SubscriptionPurchaseLineItem.itemReplacement 필드를 SubscriptionPurchaseV2에서 사용할 수 있습니다. 이 필드는 교체되는 항목에 관한 세부정보를 제공합니다(해당하는 경우).

• 이제 주문 API에 offerPhaseDetails 필드가 포함되어 비례 배분 기간에 대한 주문 자금 조달에 관한 자세한 정보를 제공합니다.

• 현재 이러한 새로운 기능은 API를 통해서만 사용할 수 있으며 클라이언트 라이브러리를 통해서는 사용할 수 없습니다.

2025년 9월 11일

새로운 기능

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

  이 메서드는 클라이언트 라이브러리에 cancellationType 매개변수 지원을 도입하여 기존 purchases.subscriptions.cancel 기능을 개선합니다.

• 가격 인상 동의 기능은 다음에서 사용할 수 있습니다.

  • SubscriptionPurchaseV2에 새 필드(SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details)가 추가됩니다.

  • 새로운 실시간 개발자 알림 유형 SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED를 사용할 수 있습니다.

2025년 6월 30일

새로운 기능

• 일회성 제품에 대한 여러 구매 옵션 및 혜택을 지원하는 새로운 ProductPurchaseV2 API를 사용할 수 있습니다.

2025년 5월 21일

지원 중단

• 일부 정기 결제 API가 지원 중단되었습니다. 자세한 내용은 정기 결제 API 지원 중단을 참고하세요.

새로운 기능

• SubscriptionPurchaseV2에서 사용할 수 있는 새 필드는 다음과 같습니다.

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• 이제 subscriptionsv2.revoke 메서드가 item_based_refund 옵션을 제공합니다.

• 이제 Orders API에서 get 및 batchGet 메서드를 제공합니다.

기타 변경사항

• purchases.subscriptions API에서 subscriptionId 매개변수는 선택사항입니다.