REST Resource: purchases.products

리소스: ProductPurchase

ProductPurchase 리소스는 사용자의 인앱 상품 구매 상태를 나타냅니다.

JSON 표현
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
필드
kind

string

이 종류는 androidpublisher 서비스의 inappPurchase 객체를 나타냅니다.

purchaseTimeMillis

string (int64 format)

제품이 구매된 시간을 에포크 기준 시간 (1970년 1월 1일) 이후 밀리초 단위로 나타낸 것입니다.

purchaseState

integer

주문의 구매 상태입니다. 가능한 값은 0입니다. 구매일 1. 취소됨 2. 대기 중

consumptionState

integer

인앱 상품의 소비 상태입니다. 가능한 값은 0입니다. 아직 소비되지 않음 1. 소비함

developerPayload

string

주문의 추가 정보가 포함된 개발자 지정 문자열입니다.

orderId

string

인앱 상품의 구매와 연결된 주문 ID입니다.

purchaseType

integer

인앱 상품의 구매 유형입니다. 이 필드는 표준 인앱 결제 흐름을 사용하여 구매하지 않은 경우에만 설정됩니다. 가능한 값은 0입니다. 테스트 (라이선스 테스트 계정에서 구매) 1. 프로모션 (프로모션 코드를 사용하여 구매) Play 포인트 구매는 포함되지 않습니다. 2. 보상형 광고 (즉, 유료 광고 대신 동영상 광고 시청)

acknowledgementState

integer

인앱 상품의 확인 상태입니다. 가능한 값은 0입니다. 아직 승인되지 않음 1. 확인됨

purchaseToken

string

이 구매를 식별하기 위해 생성된 구매 토큰입니다. 없을 수 있습니다.

productId

string

인앱 상품 SKU입니다. 없을 수 있습니다.

quantity

integer

인앱 상품 구매와 연결된 수량입니다. 없는 경우 수량은 1입니다.

obfuscatedExternalAccountId

string

앱에서 사용자 계정과 고유하게 연결된 ID의 난독화된 버전입니다. 구매가 이루어졌을 때 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid를 사용하여 지정된 경우에만 표시됩니다.

obfuscatedExternalProfileId

string

앱 내 사용자 프로필과 고유하게 연결된 ID의 난독화된 버전입니다. 구매가 이루어졌을 때 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid를 사용하여 지정된 경우에만 표시됩니다.

regionCode

string

제품이 부여된 시점 사용자의 ISO 3166-1 alpha-2 청구 지역 코드입니다.

refundableQuantity

integer

환불 가능한 수량, 즉 환불되지 않은 수량입니다. 이 값은 수량 기준 부분 환불과 전액 환불을 반영합니다.

메서드

acknowledge

인앱 상품의 구매를 확인합니다.

consume

인앱 상품 구매를 소비합니다.

get

인앱 상품의 구매 및 소비 상태를 확인합니다.