Method: purchases.voidedpurchases.list

취소, 환불 또는 지불 거절된 구매를 나열합니다.

HTTP 요청

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

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

경로 매개변수

매개변수
packageName

string

무효화된 구매가 반환되어야 하는 애플리케이션의 패키지 이름입니다 (예: 'com.some.thing').

쿼리 매개변수

매개변수
pageSelection.maxResults

integer (uint32 format)

목록 작업에서 반환해야 하는 결과의 수를 정의합니다. 기본 수는 리소스 컬렉션에 따라 정해집니다.
pageSelection.startIndex

integer (uint32 format)

반환할 첫 번째 요소의 색인을 정의합니다. 색인이 생성된 Paging을 사용 설정하는 데만 사용할 수 있습니다.
pageSelection.token

string

반환할 페이지의 토큰을 정의하며, 보통 TokenPagination에서 가져옵니다. 토큰 Paging이 사용 설정된 경우에만 사용할 수 있습니다.
startTime

string (int64 format)

응답에 표시하고자 하는 무효화된 구매 시간 중에 가장 오래된 시간(에포크 이후, 밀리초 단위)입니다. 이 매개변수의 값은 30일 이상일 수 없으며, 페이지로 나누기 토큰이 설정된 경우 무시됩니다. 기본값은 현재 시간에서 30일을 뺀 값입니다. 참고: 이 필터는 응답에 반환된 실제 무효화 시점이 아니라 시스템에서 레코드가 무효로 표시되는 시점에 적용됩니다.
endTime

string (int64 format)

응답에 표시하고자 하는 무효화된 구매 시간 중에 최근 시간(에포크 이후, 밀리초 단위)입니다. 이 매개변수의 값은 현재 시간보다 클 수 없으며, 페이지로 나누기 토큰이 설정된 경우 무시됩니다. 기본값은 현재 시간입니다. 참고: 이 필터는 응답에 반환된 실제 무효화 시점이 아니라 시스템에서 레코드가 무효로 표시되는 시점에 적용됩니다.
type

integer

응답에 표시하고자 하는 무효화된 구매의 유형입니다. 가능한 값은 0입니다. 무효화된 인앱 상품 구매만 응답에 반환할 수 있습니다. 기본값입니다. 1. 무효화된 인앱 구매와 무효화된 정기 결제 구매가 응답에 모두 반환됩니다.

참고: 무효화된 정기 결제 구매 수신을 요청하기 전에 응답에서 일회성 구매와 정기 결제를 고유하게 식별하는 orderId를 사용하도록 전환해야 합니다. 전환하지 않으면 정기 결제 갱신 주문에서 동일한 PurchaseToken을 공유하므로 PurchaseToken이 동일한 여러 정기 결제 주문을 수신하게 됩니다.
includeQuantityBasedPartialRefund

boolean

선택사항입니다. 수량 기반의 부분 환불 중 무효화된 구매가 포함되었는지 여부를 나타내며, 이는 다중 수량 구매에만 적용됩니다. true인 경우, 수량 기반의 부분 환불 중 환불된 수량을 나타내는 voidedQuantity를 사용해 무효화된 구매를 추가로 반환할 수 있습니다. 기본값은 false입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

voidedpurchases.list API에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
필드
pageInfo

object (PageInfo)

일반적인 페이지로 나누기 정보입니다.
tokenPagination

object (TokenPagination)

토큰 페이지로 나누기의 페이지로 나누기 정보입니다.
voidedPurchases[]

object (VoidedPurchase)

승인 범위

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

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

PageSelection

voidedpurchases.list 작업에서 반환해야 하는 결과와 그 수량을 정의하는 pageSelection 요청 매개변수의 유형입니다.

JSON 표현 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
필드
maxResults

integer (uint32 format)

목록 작업에서 반환해야 하는 결과의 수를 정의합니다. 기본 수는 리소스 컬렉션에 따라 정해집니다.
startIndex

integer (uint32 format)

반환할 첫 번째 요소의 색인을 정의합니다. 색인이 생성된 Paging을 사용 설정하는 데만 사용할 수 있습니다.
token

string

반환할 페이지의 토큰을 정의하며, 보통 TokenPagination에서 가져옵니다. 토큰 Paging이 사용 설정된 경우에만 사용할 수 있습니다.