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의 광고 항목이 있는 익스피디아 주문

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에서 결제 수단 데이터를 제공했습니다. 결제 대행업체가 여기(https://developers.google.com/pay/api/)에서 Google 지원 결제 대행업체로 등록되어 있는 경우 링크를 통해 결제 대행업체로 이동하여 자세한 내용을 확인할 수 있습니다. 그 외의 경우에는 다음 문서에서 페이로드 세부정보를 확인하세요. 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 당좌 예금 계좌 **** 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 / INORRECT_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)

캐릭터의 이미지