REST Resource: availabilityOrders

리소스: AvailabilityOrder

재고 순서는 AvailabilityLines의 모음입니다. 재고 순서는 구매자가 만듭니다. 판매자가 응답으로 재고를 업데이트합니다.

워크플로는 다음과 같습니다.

  • 구매자는 재고 주문과 항목을 생성하고 상태를 대기 중으로 설정합니다. 구매자가 재고 주문이나 항목을 추가로 변경할 수 없습니다.
  • 판매자는 재고 조건으로 완료하거나 거부됨으로 표시하여 모든 재고 행에 대해 조치를 취합니다. 주문과 광고 항목이 대기 중 상태인 경우에만 완료 또는 거부 작업이 가능합니다.
  • 판매자는 complete 맞춤 액션을 사용하여 재고 요청을 완료로 표시합니다. 완료된 후에는 재고 순서 또는 하위 행을 추가로 변경할 수 없습니다.
JSON 표현
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
필드
name

string

출력 전용입니다. 재고 주문의 리소스 이름으로, availabilityOrders/{id} 형식입니다.

description

string

출력 전용입니다. 재고 순서를 설명하는 추가적인 자유 형식 필드입니다.

state

enum (State)

출력 전용입니다. 이 재고 주문의 상태입니다. AvailabilityOrder의 수명 주기는 AvailabilityOrder.State를 참고하세요.

판매자는 Complete 맞춤 메서드를 사용하여 STATE_COMPLETED로 설정할 수 있습니다.

pendingExpirationTime

string (Timestamp format)

출력 전용입니다. 대기 중인 재고 주문의 만료 타임스탬프입니다. 판매자는 대기 중인 재고 주문이 만료되기 전에 완료해야 합니다. 그렇지 않으면 재고가 없는 것으로 완료된 것으로 간주됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

createTime

string (Timestamp format)

출력 전용입니다. 생성 타임스탬프입니다. 시스템에서 할당합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 최종 업데이트 타임스탬프입니다. 시스템에서 할당합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

advertiserInfo

object (AdvertiserInfo)

출력 전용입니다. 광고주 정보

재고 주문 상태에 사용할 수 있는 값입니다.

열거형
STATE_UNSPECIFIED 재고 주문 상태가 지정되지 않았거나 이 버전에서 알 수 없는 경우의 기본값입니다.
STATE_PENDING 구매자가 재고 요청 설정을 제공했을 때 재고 상태를 대기 중입니다.
STATE_COMPLETED 판매자가 모든 행에 대해 재고 응답을 제공한 경우 완료된 재고 상태입니다.
STATE_CANCELLED 판매자가 모든 항목에 대해 재고 응답을 제공하기 전에 구매자가 취소 요청을 제공한 경우 재고 상태가 취소됨.
STATE_EXPIRED 판매자가 완료하기 전에 주문이 만료된 경우 재고 만료 상태입니다.

메서드

complete

기존 재고 주문을 완료로 표시합니다.

get

개별 재고 주문을 검색합니다.

list

재고 주문을 나열합니다.