Method: orders.reviewrefund

지불 거절 요청에 대한 환불 환경설정 및 구매 사용량 제공

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 이 정기 결제 또는 인앱 상품의 구매가 이루어진 애플리케이션의 패키지 이름입니다 (예: 'com.some.thing').
orderId

string

필수 항목입니다. 정기 결제 또는 인앱 주문이 구매되었을 때 사용자에게 제공된 주문 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
필드
pendingRefundToken

string

필수 항목입니다. 대기 중인 환불 검토 알림에 포함된 대기 중인 환불 토큰입니다.
sampleContentProvided

boolean

필수 항목입니다. 구매 전에 무료 샘플, 체험판 또는 기능에 관한 정보를 제공했는지 여부를 나타냅니다.
refundPreference

enum (RefundPreference)

필수 항목입니다. Play 스토어에서 환불을 승인해야 하는지 여부에 관한 운영 논리에 따른 환경설정을 나타냅니다.
consumptionPercentageMilliunits

integer

선택사항입니다. 고객이 사용한 인앱 구매의 비율입니다(단위: 밀리). 최소: 0, 최대: 100,000 유료 앱의 경우 생략할 수 있습니다. 예 : 45200은 45.2%를 나타냅니다.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

선택사항입니다. 사용자가 구매한 상품 또는 서비스를 소비하거나 사용한 인스턴스를 각각 나타내는 이벤트 목록입니다. 항목이 1,000개를 초과하는 목록은 거부됩니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

RefundPreference

Play 스토어에서 환불을 승인해야 하는지 여부에 관한 운영 논리에 따른 환경설정을 나타냅니다.

열거형
REFUND_PREFERENCE_UNSPECIFIED orders.refund 환경설정이 지정되지 않았습니다. 이 값은 사용되지 않습니다.
DECLINE 개발자가 Play에서 환불을 거부하기를 원합니다.
APPROVE 개발자가 Play에서 전액 환불을 승인해 주기를 원합니다.
NEUTRAL 개발자가 Google Play의 환불 결정에 대해 선호하는 사항이 없음

ConsumptionUsageEvent

사용자가 구매한 상품 또는 서비스를 소비하거나 사용한 인스턴스를 각각 나타내는 이벤트 목록입니다.

JSON 표현 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
필드
obfuscatedAccountId

string

선택사항입니다. 앱에서 구매자의 사용자 계정과 고유하게 연결된 난독화된 문자열입니다. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

선택사항입니다. 앱에서 구매자의 사용자 프로필과 고유하게 연결된 난독화된 문자열입니다. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

선택사항입니다. 사용자가 콘텐츠를 소비, 사용, 다운로드, 열거나 스트리밍한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
ipAddress

string

선택사항입니다. 소비가 발생한 IP 주소입니다.
consumptionItemDescription

string

선택사항입니다. 개발자가 소비된 항목에 관한 자세한 정보를 제공할 수 있는 자유 형식 텍스트입니다. 최대 길이는 5,000자(영문 기준)입니다.
location

object (CoarseLocation)

선택사항입니다. 소비가 발생한 지리적 위치입니다.

CoarseLocation

소비가 발생한 위치의 대략적인 지리적 위치 세부정보입니다.

JSON 표현 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
필드
regionCode

string

필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이 값은 추론되지 않으며 값의 정확성은 사용자의 책임입니다. 예: 스위스의 경우 'CH'.
administrativeArea

string

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 스페인의 경우 광역 자치주가 아니라 주(province)입니다(예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 locality를 비워 둡니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구 또는 구일 수 있습니다. 대부분의 주소에서는 이를 생략할 수 있습니다.