Order

주문 항목. 참고: 1. 달리 명시되지 않는 한, 모든 수준의 모든 문자열은 1,000자(영문 기준) 미만이어야 합니다. 2. 달리 명시되지 않는 한, 모든 수준에서 반복되는 모든 필드의 수는 50개 미만이어야 합니다. 3. 지정된 경우 모든 수준의 모든 타임스탬프는 유효한 타임스탬프여야 합니다.

JSON 표현 
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
필드
googleOrderId

string

Google에서 할당한 주문 ID입니다.
merchantOrderId

string

필수: 판매자가 할당한 내부 주문 ID입니다. 이 ID는 고유해야 하며 후속 주문 업데이트 작업에 필요합니다. 이 ID는 제공된 googleOrderId 또는 다른 고유한 값으로 설정할 수 있습니다. 사용자에게 표시되는 ID는 userVisibleOrderId이며 더 사용자 친화적인 다른 값일 수 있습니다. 최대 허용 길이는 128자(영문 기준)입니다.
userVisibleOrderId

string

현재 주문을 참조하는 사용자에게 표시되는 ID입니다. 이 ID는 웹사이트, 앱, 이메일을 비롯한 다른 환경에서 이 주문에 대해 표시된 ID와 일치해야 합니다.
userVisibleStateLabel
(deprecated)

string

지원 중단됨: 대신 OrderExtensions 상태를 사용하세요. 이 주문의 상태에 대해 사용자에게 표시되는 라벨입니다.
buyerInfo

object (UserInfo)

구매자 관련 정보
image

object (Image)

주문과 관련된 이미지입니다.
createTime

string (Timestamp format)

필수: 주문이 생성된 날짜 및 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

주문이 마지막으로 업데이트된 날짜 및 시간입니다. OrderUpdate에 필요합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"
transactionMerchant

object (Merchant)

결제를 지원한 판매자입니다. 이는 광고 항목 수준 제공업체와 다를 수 있습니다. 예: ANA의 항목이 포함된 Expedia 주문
contents

object (Contents)

필수: 광고 항목 그룹인 콘텐츠를 주문합니다.
priceAttributes[]

object (PriceAttribute)

가격, 할인, 세금 등
followUpActions[]

object (Action)

주문 수준의 후속 조치
paymentData

object (PaymentData)

주문의 결제 관련 데이터입니다.
termsOfServiceUrl

string

주문/제안된 주문에 적용되는 서비스 약관으로 연결되는 링크입니다.
note

string

주문에 첨부된 메모
promotions[]

object (Promotion)

이 주문과 관련된 모든 프로모션입니다.
disclosures[]

object (Disclosure)

이 주문과 관련된 정보 공개입니다.
vertical
(deprecated)

object

지원 중단됨: 카테고리를 대신 사용하세요. 이러한 속성은 일부 광고 항목에서 재정의하지 않는 한 모든 광고 항목에 적용됩니다. 이 카테고리는 광고 항목 수준 카테고리 유형과 일치해야 합니다. 가능한 값: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }
통합 필드 verticals. 이러한 속성은 일부 광고 항목에서 재정의하지 않는 한 모든 광고 항목에 적용됩니다. 이 카테고리는 광고 항목 수준 카테고리 유형과 일치해야 합니다. verticals은 다음 중 하나여야 합니다.
purchase

object (PurchaseOrderExtension)

주문서
ticket

object (TicketOrderExtension)

티켓 주문

목차

광고 항목의 래퍼입니다.

JSON 표현 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
필드
lineItems[]

object (LineItem)

주문 광고 항목의 목록입니다. 광고 항목이 1개 이상 있어야 하며 50개 이하여야 합니다. 모든 광고 항목은 동일한 카테고리에 속해야 합니다.

PaymentData

주문과 관련된 결제 데이터입니다.

JSON 표현 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
필드
paymentResult

object (PaymentResult)

통합업체가 거래를 완료하는 데 사용하는 결제 결과입니다. actions-on-Google에서 결제 환경을 관리하는 경우 Google의 작업에 의해 이 필드가 채워집니다.
paymentInfo

object (PaymentInfo)

사용자 대면 상호작용에 유용한 주문 관련 결제 정보입니다.

PaymentResult

통합업체가 거래를 완료하기 위해 사용한 결제 결과입니다.

JSON 표현 
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
필드
통합 필드 result. Google 결제 데이터 또는 판매자 결제 수단이 제공되었습니다. result은 다음 중 하나여야 합니다.
googlePaymentData

string

Google에서 결제 수단 데이터를 제공했습니다. 결제 대행업체가 Google 지원 결제 대행업체로 등록되어 있는 경우(https://developers.google.com/pay/api/) 링크를 통해 결제 대행업체로 이동하여 자세한 내용을 알아보세요. 그렇지 않은 경우 페이로드 세부정보는 다음 문서를 참조하세요. https://developers.google.com/pay/api/payment-data-cryptography
merchantPaymentMethodId

string

사용자가 선택한 판매자/작업 제공 결제 수단입니다.

PaymentInfo

주문에 관한 결제 정보입니다. 이 프로토콜은 사용자 대면 상호작용에 유용한 정보를 캡처합니다.

JSON 표현 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
필드
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

거래에 사용된 결제 수단의 표시 정보입니다.
paymentMethodProvenance

enum (PaymentMethodProvenance)

거래에 사용된 결제 수단의 출처입니다. 사용자가 Google과 판매자 모두에 동일한 결제 수단을 등록했을 수 있습니다.

PaymentMethodDisplayInfo

통합업체가 거래를 완료하기 위해 사용한 결제 결과입니다.

JSON 표현 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
필드
paymentType

enum (PaymentType)

결제 유형입니다.
paymentMethodDisplayName

string

사용자에게 표시되는 결제 수단 이름입니다. 예: VISA **** 1234 Check acct **** 5678

프로모션

장바구니에 추가된 프로모션/혜택입니다.

JSON 표현 
{
  "coupon": string
}
필드
coupon

string

필수: 이 혜택에 적용되는 쿠폰 코드입니다.

PurchaseOrderExtension

구매 카테고리용 주문 광고 확장 이러한 속성은 광고 항목에서 재정의하지 않는 한 주문 내 모든 광고 항목에 적용할 수 있습니다.

JSON 표현 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
필드
status

enum (PurchaseStatus)

필수: 주문의 전체 상태입니다.
userVisibleStatusLabel

string

사용자에게 표시되는 상태의 라벨/문자열입니다. 최대 허용 길이는 50자(영문 기준)입니다.
type

enum (PurchaseType)

필수: 구매 유형입니다.
returnsInfo

object (PurchaseReturnsInfo)

주문 관련 반품 정보
fulfillmentInfo

object (PurchaseFulfillmentInfo)

주문의 처리 정보입니다.
extension

object

판매자와 Google 간에 교환된 추가 입력란입니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }
purchaseLocationType

enum (PurchaseLocationType)

구매 위치 (매장 / 온라인)
errors[]

object (PurchaseError)

선택사항: 이 주문이 거부된 오류입니다.

PurchaseError

구매주문서가 거부될 수 있는 오류입니다.

JSON 표현 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
필드
type

enum (ErrorType)

필수: 판매자가 주문을 거부하는 상세한 이유를 나타냅니다.
description

string

추가 오류 설명입니다.
entityId

string

오류에 해당하는 엔티티 ID입니다. 예를 들어 LineItemId / ItemOptionId에 해당할 수 있습니다.
updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE 오류 유형의 경우와 관련이 있습니다.
availableQuantity

integer

현재 재고 수량입니다. AVAILABILITY_CHANGED인 경우 적용됩니다.

TicketOrderExtension

영화, 스포츠 등의 티켓 주문 콘텐츠를 주문합니다.

JSON 표현 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
필드
ticketEvent

object (TicketEvent)

이벤트가 모든 광고 항목 티켓에 적용됩니다.

TicketEvent

단일 이벤트를 나타냅니다.

JSON 표현 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
필드
type

enum (Type)

필수: 티켓 이벤트의 유형입니다. 예: 영화, 콘서트 등
name

string

필수 항목: 이벤트 이름입니다. 예를 들어 이벤트가 영화인 경우 영화 이름이어야 합니다.
description

string

이벤트 설명입니다.
url

string

이벤트 정보의 URL입니다.
location

object (Location)

이벤트가 열리는 위치 또는 조직이 있는 위치입니다.
eventCharacters[]

object (EventCharacter)

이 이벤트와 관련된 문자입니다. 영화 이벤트의 감독이나 배우, 콘서트 공연자 등이 될 수 있습니다.
startDate

object (Time)

시작 시간
endDate

object (Time)

종료 시간
doorTime

object (Time)

입장 시간이며 이벤트 시작 시간과 다를 수 있습니다. 예: 이벤트는 오전 9시에 시작하지만 입장 시간은 오전 8시 30분입니다.

EventCharacter

이벤트 문자 1개. 예: 주최자, 공연자 등

JSON 표현 
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
필드
type

enum (Type)

이벤트 문자의 유형입니다. 예: 직접 선택할 수 있습니다.
name

string

문자의 이름입니다.
image

object (Image)

캐릭터의 이미지