REST Resource: orders

리소스: 주문

주문 리소스는 Google Play에서 이루어진 거래에 관한 포괄적인 정보를 캡슐화합니다. 여기에는 주문 자체, 구매한 제품, 주문과 관련된 이벤트 기록에 관한 세부정보를 제공하는 다양한 속성이 포함됩니다.

주문 API는 Google Play 생태계 내에서 주문 데이터에 실시간으로 액세스할 수 있도록 지원합니다. 청구, 세금, 환불과 같은 거래 세부정보와 정기 결제의 가격 책정 단계와 같은 메타데이터를 포함하여 일회성 주문과 반복 주문 모두에 대한 세부정보와 메타데이터를 가져올 수 있습니다. 주문 API를 사용하면 주문 관리와 관련된 작업을 자동화하여 Play Console을 통한 수동 확인의 필요성을 줄일 수 있습니다.

이 API의 사용 사례는 다음과 같습니다.

  • 실시간 주문 데이터 검색 - 주문 ID를 사용하여 구매 직후 주문 세부정보 및 메타데이터를 가져옵니다.

  • 주문 업데이트 동기화 - 주문 정보를 최신 상태로 유지하기 위해 주문 업데이트를 주기적으로 동기화합니다.

참고:

  • 주문 API 호출은 Play Developer API 할당량에 포함되며, 기본적으로 일일 20만 개로 설정되어 있어 광범위한 주문 기록을 동기화하기에 충분하지 않을 수 있습니다.

  • 호출당 최대 1,000개의 주문을 가져올 수 있습니다. 할당량 사용을 최소화하려면 더 큰 페이지 크기를 사용하는 것이 좋습니다. Cloud Console에서 할당량을 확인하고 필요한 경우 추가 할당량을 요청하세요.

JSON 표현 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ],
  "salesChannel": enum (SalesChannel),
  "orderId": string,
  "purchaseToken": string,
  "state": enum (State),
  "createTime": string,
  "lastEventTime": string,
  "buyerAddress": {
    object (BuyerAddress)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },
  "orderDetails": {
    object (OrderDetails)
  },
  "orderHistory": {
    object (OrderHistory)
  },
  "developerRevenueInBuyerCurrency": {
    object (Money)
  },
  "pointsDetails": {
    object (PointsDetails)
  }
}
필드
lineItems[]

object (LineItem)

이 주문을 구성하는 개별 광고 항목입니다.
salesChannel

enum (SalesChannel)

주문의 발신 판매 채널입니다.
orderId

string

주문 ID입니다.
purchaseToken

string

정기 결제 또는 상품이 구매되었을 때 사용자 기기에 제공된 토큰입니다.
state

enum (State)

주문의 상태입니다.
createTime

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"입니다.
lastEventTime

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"입니다.
buyerAddress

object (BuyerAddress)

세금 계산에 사용할 고객의 주소 정보입니다. Google이 주문의 등록된 판매자인 경우 국가만 표시됩니다.
total

object (Money)

할인 및 세금을 감안하여 고객이 지불한 최종 금액입니다.
tax

object (Money)

이 주문의 일환으로 지불된 총 세금입니다.
orderDetails

object (