REST Resource: orders.lines

리소스: 행

구성된 제품을 나타내는 단일 주문 행입니다.

JSON 표현 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "lineState": enum (LineState),
  "rejection": {
    object (Rejection)
  },
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
필드
name

string

출력 전용입니다. 줄의 리소스 이름으로, orders/{order_id}/lines/{id} 형식입니다.
product

string

출력 전용입니다. 이 줄이 구성 중인 Product의 이름입니다. 형식 = products/123
externalId

string

선택사항입니다. 이 항목을 외부 소스에 매핑하는 데 사용되는 ID입니다.
displayName

string

출력 전용입니다. 선의 표시 이름입니다.
description

string

출력 전용입니다. 선을 설명하는 추가 자유형 필드입니다.
lineState

enum (LineState)

출력 전용입니다. 선의 상태입니다. 선의 수명 주기는 LineState를 참고하세요.

판매자는 Reserve, Book, Reject 맞춤 메서드를 사용하여 다음 중 하나로 설정할 수 있습니다.

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

다른 모든 광고 상태는 구매자가 설정합니다.
rejection

object (Rejection)

선택사항입니다. 노선의 거부 세부정보입니다.
startTime
(deprecated)

string (Timestamp format)

출력 전용입니다. 광고 항목이 게재되기 시작하는 시점입니다 (해당 날짜 포함).

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

string (Timestamp format)

출력 전용입니다. 광고 항목의 게재가 중단되는 시점입니다 (제외).

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

object (Date)

출력 전용입니다. 광고 항목이 게재되기 시작하는 날짜입니다 (해당 날짜 포함). 광고 단위와 동일한 시간대입니다.
endDate

object (Date)

출력 전용입니다. 광고 항목의 게재가 종료되는 날짜입니다 (해당 날짜 포함). 광고 단위와 동일한 시간대입니다.
budget

object (Money)

출력 전용입니다. 선의 예산입니다.
lineTerms

object (LineTerms)

출력 전용입니다. 이 항목에 대한 판매자의 보장 조건입니다.
pendingReservationExpirationTime

string (Timestamp format)

출력 전용입니다. 대기 중인 예약의 만료 타임스탬프입니다. 판매자는 대기 중인 예약이 만료되기 전에 예약하거나 거부해야 합니다. 그러지 않으면 거부된 것으로 간주됩니다.

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

string (Timestamp format)

출력 전용입니다. 예약의 만료 타임스탬프입니다. 구매자는 예약이 만료되기 전에 예약해야 합니다. 그렇지 않으면 예약이 취소된 것으로 처리됩니다.

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

object (Targeting)

출력 전용입니다. 노선의 타겟팅입니다.
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"입니다.

LineState

선의 상태입니다.

열거형
LINE_STATE_UNSPECIFIED 이 버전에서 선 상태가 지정되지 않았거나 알 수 없는 경우의 기본값입니다.
LINE_STATE_PENDING_RESERVATION 구매자가 라인을 작성했으며 제품을 예약하고 가격 및 재고 정보로 업데이트할 것을 요청하고 있습니다.
LINE_STATE_RESERVED 판매자가 예약한 회선입니다. 이 상태는 이전 상태가 예약 대기 중인 경우에만 나타날 수 있습니다.
LINE_STATE_PENDING_BOOKING 구매자가 예약을 수락하고 라인 예약을 요청하고 있습니다.
LINE_STATE_BOOKED 판매자가 회선을 예약했습니다. 이 상태는 이전 주가 예약 대기 중인 경우에만 표시될 수 있습니다. 이 단계에서는 신청이 거부되지 않습니다.
LINE_STATE_REJECTED_BY_SELLER 판매자가 라인을 거부했습니다. 이 상태는 이전 상태가 예약 대기 중인 경우에만 나타날 수 있습니다.
LINE_STATE_CANCELLED_BY_BUYER 구매자가 줄을 취소했습니다.
LINE_STATE_PENDING_RESERVATION_EXPIRED 예약 대기 중에 노선이 만료되었습니다.
LINE_STATE_RESERVED_EXPIRED 회선이 예약 기간 중에 만료되어 구매자의 응답을 기다리는 중입니다.

메서드

book

 기존 노선을 예약합니다.

get

 주문의 개별 행을 검색합니다.

list

 주문의 행을 나열합니다.

patch

 기존 줄을 업데이트합니다.

reject

 기존 선을 거부합니다.

reserve

 기존 노선을 예약합니다.