REST Resource: purchases.productsv2

리소스: ProductPurchaseV2

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

JSON 표현 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
필드
productLineItem[]

object (ProductLineItem)

ProductPurchaseV2의 상품 수준 정보를 포함합니다.
kind

string

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

object (PurchaseStateContext)

구매의 구매 상태에 관한 정보입니다.
testPurchaseContext

object (TestPurchaseContext)

테스트 구매와 관련된 정보입니다. 이는 테스트 구매에 대해서만 설정됩니다.
orderId

string

인앱 상품 구매와 연결된 주문 ID입니다. 구매와 연결된 주문이 없는 경우 설정되지 않을 수 있습니다.
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 청구서 수신 지역 코드입니다.
purchaseCompletionTime

string (Timestamp format)

구매가 완료된 시간입니다(즉, PurchaseState가 PURCHASED로 변경된 시간). 결제가 완료될 때까지 이 입력란은 표시되지 않습니다. 예를 들어 사용자가 대기 중인 거래 (https://developer.android.com/google/play/billing/integrate#pending)를 시작한 경우 사용자가 거래를 완료하는 데 필요한 단계를 완료할 때까지 이 필드는 채워지지 않습니다.

생성된 출력은 항상 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"입니다.
acknowledgementState

enum (AcknowledgementState)

출력 전용입니다. 구매의 확인 상태입니다.

PurchaseStateContext

구매 상태에 관한 컨텍스트입니다.

JSON 표현 
{
  "purchaseState": enum (PurchaseState)
}
필드
purchaseState

enum (PurchaseState)

출력 전용입니다. 구매의 구매 상태입니다.

PurchaseState

가능한 구매 상태입니다.

열거형
PURCHASE_STATE_UNSPECIFIED 구매 상태가 지정되지 않았습니다. 이 값은 설정하면 안 됩니다.
PURCHASED 구매가 완료되었습니다.
CANCELLED 주문이 취소되었습니다.
PENDING 구매가 대기 중 상태이며 아직 완료되지 않았습니다. 대기 중인 구매 처리에 관한 자세한 내용은 https://developer.android.com/google/play/billing/integrate#pending를 참고하세요.

TestPurchaseContext

테스트 구매에 관한 컨텍스트입니다.

JSON 표현 
{
  "fopType": enum (FopType)
}
필드
fopType

enum (FopType)

테스트 구매의 fop 유형입니다.

FopType

가능한 fop 유형입니다.

열거형
FOP_TYPE_UNSPECIFIED FOP 유형이 지정되지 않았습니다. 이 값은 설정하면 안 됩니다.
TEST 테스트 카드를 사용하여 구매가 이루어졌습니다.

ProductLineItem

ProductPurchaseV2의 상품 수준 정보를 포함합니다.

JSON 표현 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
필드
productId

string

구매한 제품 ID (예: 'monthly001')입니다.
productOfferDetails

object (ProductOfferDetails)

이 항목의 혜택 세부정보입니다.

ProductOfferDetails

구매 항목 관련 혜택 세부정보입니다.

JSON 표현 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
필드
offerTags[]

string

혜택과 연결된 최신 혜택 태그입니다. 구매 옵션에서 상속받은 태그가 포함됩니다.
offerId

string

오퍼 ID 제품에만 표시됩니다.
purchaseOptionId

string

구매 옵션 ID입니다.
rentOfferDetails

object (RentOfferDetails)

대여 혜택에 대한 세부정보입니다. 이 속성은 대여 광고 항목에만 설정됩니다.
offerToken

string

이 구매 광고 항목을 만드는 데 사용된 거래별 제품 토큰입니다.
quantity

integer

인앱 상품 구매와 관련된 수량입니다.
refundableQuantity

integer

환불 대상 수량입니다. 즉, 환불되지 않은 수량입니다. 이 값은 수량 기반 부분 환불 및 전액 환불을 반영합니다.
consumptionState

enum (ConsumptionState)

출력 전용입니다. 구매의 소비 상태입니다.

RentOfferDetails

이 유형에는 필드가 없습니다.

대여 항목 관련 혜택 세부정보입니다.

ConsumptionState

가능한 소비 상태입니다.

열거형
CONSUMPTION_STATE_UNSPECIFIED 소비 상태가 지정되지 않았습니다. 이 값은 설정하면 안 됩니다.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED 아직 소비되지 않았습니다.
CONSUMPTION_STATE_CONSUMED 이미 사용되었습니다.

AcknowledgementState

일회성 제품의 확인 상태입니다.

열거형
ACKNOWLEDGEMENT_STATE_UNSPECIFIED 지정되지 않은 확인 상태입니다.
ACKNOWLEDGEMENT_STATE_PENDING 구매가 아직 확인되지 않았습니다.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED 구매가 확인되었습니다.

메서드

getproductpurchasev2

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