Google Play Developer API 출시 노트

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

2026년 7월 6일

새로운 기능

• 지불 거절 비용의 책임 업데이트: 이제 Google Play에서 공동 지불 거절 이의 제기 절차를 지원합니다.

  • 환불 검토 대기중 알림: 사용자가 검토가 필요한 지불 거절을 요청하면 새로운 실시간 개발자 알림 (RTDN) 유형인 PendingRefundReviewNotification이 전송됩니다. 검토 대기중은 환불 사유로 CHARGEBACK만 지원합니다.

  • ReviewRefund API: 새로운 orders.reviewrefund API를 호출하여 이러한 요청을 평가하고 24시간 이내에 응답할 수 있습니다. API 호출에서 환불 환경설정 (예: APPROVE, DECLINE, NEUTRAL)과 관련 구매 사용 증거 (예: 사용자 IP 주소, 누적 소비율, 대략적인 지리적 위치)를 제공하여 Google Play에서 지불 거절에 이의를 제기할 수 있도록 해야 합니다.

2026년 5월 19일

새로운 기능

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

지원 중단

• 일부 정기 결제 API가 지원 중단됩니다. 자세한 내용은 2026년 5월 정기 결제 API 지원 중단을 참고하세요.

2026년 1월 27일

새로운 기능

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

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

2025년 11월 19일

새로운 기능

• 향상된 재구독 처리.

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

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

• 이제 Orders API에 offerPhaseDetails 필드가 포함되어 일할 계산 기간에 자금을 지원하는 주문에 관한 자세한 정보를 제공합니다.

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 메서드를 제공합니다.

기타 변경사항

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