Google Play Developer API 출시 노트

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

2026년 7월 6일

새로운 기능

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

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

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

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 메서드를 통해 단일 정기 결제와 부가기능이 있는 정기 결제 모두에 연기 기능을 사용할 수 있습니다. 부가기능이 포함된 정기 결제의 청구일을 연기하면 정기 결제의 모든 항목의 청구일이 지정된 기간만큼 연기됩니다.

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

2025년 11월 19일

새로운 기능

• 재구독 처리 개선

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

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

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

기타 변경사항

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