- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- PageSelection
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
취소, 환불 또는 지불 거절된 구매를 나열합니다.
HTTP 요청
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
packageName |
무효화된 구매를 반환해야 하는 애플리케이션의 패키지 이름입니다 (예: 'com.some.thing'). |
쿼리 매개변수
매개변수 | |
---|---|
pageSelection.maxResults |
list 작업이 반환해야 하는 결과 수를 정의합니다. 기본 개수는 리소스 컬렉션에 따라 다릅니다. |
pageSelection.startIndex |
반환할 첫 번째 요소의 색인을 정의합니다. 색인이 생성된 페이징이 사용 설정된 경우에만 사용할 수 있습니다. |
pageSelection.token |
반환할 페이지의 토큰을 정의합니다. 일반적으로 TokenPagination에서 가져옵니다. 토큰 페이징이 사용 설정된 경우에만 사용할 수 있습니다. |
startTime |
응답에 표시하려는 무효화된 구매의 시간 중 가장 오래된 시간(에포크 이후, 밀리초)입니다. 이 매개변수의 값은 30일 이전일 수 없으며 페이지로 나누기 토큰이 설정된 경우 무시됩니다. 기본값은 현재 시간에서 30일을 뺀 값입니다. 참고: 이 필터는 응답에 반환된 실제 무효화된 시간이 아니라 Google 시스템에서 무효화된 것으로 표시되는 시점에 적용됩니다. |
endTime |
응답에 표시하려는 무효화된 구매의 시간(에포크 이후, 밀리초)입니다. 이 매개변수의 값은 현재 시간보다 클 수 없으며 페이지로 나누기 토큰이 설정된 경우 무시됩니다. 기본값은 현재 시간입니다. 참고: 이 필터는 응답에 반환된 실제 무효화된 시간이 아니라 Google 시스템에서 무효화된 것으로 표시되는 시점에 적용됩니다. |
type |
응답에 표시하려는 무효화된 구매 유형입니다. 가능한 값은 0입니다. 무효화된 인앱 상품 구매만 응답에 반환됩니다. 기본값입니다. 1. 무효화된 인앱 구매와 무효화된 정기 결제 구매가 모두 응답에 반환됩니다. 참고: 무효화된 정기 결제 구매의 수신을 요청하기 전에 응답에서 일회성 구매 및 정기 결제를 고유하게 식별하는 orderId를 사용하도록 전환해야 합니다. 그렇지 않으면 구독 갱신 주문이 동일한 PurchaseToken을 공유하므로 동일한 PurchaseToken을 포함하는 여러 정기 결제 주문을 수신하게 됩니다. |
includeQuantityBasedPartialRefund |
선택사항입니다. 무효화된 수량 기반 부분 환불의 구매를 포함할지 여부(다중 수량 구매에만 적용됨) true인 경우 수량 기반 부분 환불의 환불 수량을 나타내는 voidedQuantity와 함께 무효화된 추가 구매가 반환될 수 있습니다. 기본값은 false입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
voidedpurchases.list API의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "pageInfo": { object ( |
필드 | |
---|---|
pageInfo |
일반 페이지로 나누기 정보입니다. |
tokenPagination |
토큰 페이지로 나누기를 위한 페이지로 나누기 정보입니다. |
voidedPurchases[] |
|
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
PageSelection
voidedpurchases.list 작업이 반환해야 하는 결과와 결과 수를 정의하는 pageSelection 요청 매개변수의 유형입니다.
JSON 표현 |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
필드 | |
---|---|
maxResults |
list 작업이 반환해야 하는 결과 수를 정의합니다. 기본 개수는 리소스 컬렉션에 따라 다릅니다. |
startIndex |
반환할 첫 번째 요소의 색인을 정의합니다. 색인이 생성된 페이징이 사용 설정된 경우에만 사용할 수 있습니다. |
token |
반환할 페이지의 토큰을 정의합니다. 일반적으로 TokenPagination에서 가져옵니다. 토큰 페이징이 사용 설정된 경우에만 사용할 수 있습니다. |