- JSON 표현
- 목차
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- 프로모션
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
주문 항목입니다. 참고: 1. 달리 명시되지 않는 한 모든 수준의 모든 문자열은 1,000자(영문 기준) 미만이어야 합니다. 2. 달리 명시되지 않는 한 모든 수준에서 반복되는 모든 필드는 개수가 50 미만이어야 합니다. 3. 모든 수준의 모든 타임스탬프가 지정된 경우 유효한 타임스탬프여야 합니다.
JSON 표현 | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
필드 | ||
---|---|---|
googleOrderId |
Google에서 할당한 주문 ID입니다. |
|
merchantOrderId |
필수: 판매자가 할당한 내부 주문 ID입니다. 이 ID는 고유해야 하며 후속 주문 업데이트 작업에 필요합니다. 이 ID는 제공된 googleOrderId 또는 다른 고유한 값으로 설정할 수 있습니다. 사용자에게 표시되는 ID는 userVisibleOrderId이며 이는 더 사용자 친화적인 다른 값일 수 있습니다. 허용되는 최대 길이는 128자(영문 기준)입니다. |
|
userVisibleOrderId |
현재 주문을 참조하는 사용자 대상 ID입니다. 이 ID는 웹사이트, 앱, 이메일을 비롯한 다른 컨텍스트에서 이 주문에 대해 표시되는 ID와 일치해야 합니다. |
|
userVisibleStateLabel |
지원 중단됨: 대신 OrderExtensions 상태를 사용하세요. 이 주문 상태에 대해 사용자에게 표시되는 라벨입니다. |
|
buyerInfo |
구매자에 대한 정보입니다. |
|
image |
주문과 연결된 이미지입니다. |
|
createTime |
필수: 주문이 생성된 날짜 및 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: |
|
lastUpdateTime |
주문이 마지막으로 업데이트된 날짜 및 시간입니다. OrderUpdate에 필요합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: |
|
transactionMerchant |
결제를 지원한 판매자입니다. 광고 항목 수준 제공업체와 다를 수 있습니다. 예: ANA의 광고 항목이 있는 익스피디아 주문 |
|
contents |
필수: 광고 항목 그룹인 콘텐츠를 주문합니다. |
|
priceAttributes[] |
가격, 할인, 세금 등 |
|
followUpActions[] |
주문 수준의 후속 조치 |
|
paymentData |
주문의 결제 관련 데이터입니다. |
|
termsOfServiceUrl |
주문/제안된 주문에 적용되는 서비스 약관 링크 |
|
note |
주문에 첨부된 메모입니다. |
|
promotions[] |
이 주문과 연결된 모든 프로모션입니다. |
|
disclosures[] |
이 주문과 관련된 공개 정보입니다. |
|
vertical |
지원 중단됨: 대신 카테고리를 사용하세요. 이러한 속성은 일부 광고 항목에서 재정의하지 않는 한 모든 광고 항목에 적용됩니다. 이 카테고리는 광고 항목 수준 카테고리 유형과 일치해야 합니다. 가능한 값: 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 |
|
통합 필드 verticals . 이러한 속성은 일부 광고 항목에서 재정의하지 않는 한 모든 광고 항목에 적용됩니다. 이 카테고리는 광고 항목 수준 카테고리 유형과 일치해야 합니다. verticals 은 다음 중 하나여야 합니다. |
||
purchase |
구매주문서 |
|
ticket |
티켓 주문 |
목차
광고 항목의 래퍼입니다.
JSON 표현 | |
---|---|
{
"lineItems": [
{
object ( |
필드 | |
---|---|
lineItems[] |
주문 광고 항목의 목록입니다. 광고 항목은 1개 이상 필요하며, 최대 50개까지 허용됩니다. 모든 광고 항목은 동일한 카테고리에 속해야 합니다. |
PaymentData
주문과 관련된 결제 데이터입니다.
JSON 표현 | |
---|---|
{ "paymentResult": { object ( |
필드 | |
---|---|
paymentResult |
통합업체가 거래를 완료하기 위해 사용하는 결제 결과입니다. Actions-on-Google에서 결제 환경을 관리하는 경우 이 필드는 Google 작업에 의해 채워집니다. |
paymentInfo |
사용자 대면 상호작용에 유용한 주문에 관한 결제 정보입니다. |
PaymentResult
통합업체가 거래를 완료하기 위해 사용하는 결제 결과입니다.
JSON 표현 | |
---|---|
{ // Union field |
필드 | ||
---|---|---|
통합 필드 result . Google 결제 데이터 또는 판매자 결제 수단이 제공됩니다. result 은 다음 중 하나여야 합니다. |
||
googlePaymentData |
Google에서 결제 수단 데이터를 제공했습니다. 결제 대행업체가 여기(https://developers.google.com/pay/api/)에서 Google 지원 결제 대행업체로 등록되어 있는 경우 링크를 통해 결제 대행업체로 이동하여 자세한 내용을 확인할 수 있습니다. 그 외의 경우에는 다음 문서에서 페이로드 세부정보를 확인하세요. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
판매자/작업에서 사용자가 선택한 결제 수단입니다. |
PaymentInfo
주문과 관련된 결제 정보입니다. 이 프로토콜은 사용자 대상 상호작용에 유용한 정보를 캡처합니다.
JSON 표현 | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
필드 | |
---|---|
paymentMethodDisplayInfo |
거래에 사용된 결제 수단의 표시 정보입니다. |
paymentMethodProvenance |
거래에 사용된 결제 수단의 출처 사용자가 Google과 판매자 모두에 동일한 결제 수단을 등록했을 수 있습니다. |
PaymentMethodDisplayInfo
통합업체가 거래를 완료하기 위해 사용하는 결제 결과입니다.
JSON 표현 | |
---|---|
{
"paymentType": enum ( |
필드 | |
---|---|
paymentType |
결제 유형입니다. |
paymentMethodDisplayName |
사용자에게 표시되는 결제 수단의 이름입니다. 예: VISA **** 1234 당좌 예금 계좌 **** 5678 |
프로모션
장바구니에 추가된 프로모션/혜택입니다.
JSON 표현 | |
---|---|
{ "coupon": string } |
필드 | |
---|---|
coupon |
필수: 이 혜택에 적용되는 쿠폰 코드입니다. |
PurchaseOrderExtension
구매 카테고리의 주문 광고 확장 광고 항목에서 재정의하지 않는 한, 이러한 속성은 주문에 포함된 모든 광고 항목에 적용됩니다.
JSON 표현 | |
---|---|
{ "status": enum ( |
필드 | |
---|---|
status |
필수: 주문의 전반적인 상태입니다. |
userVisibleStatusLabel |
사용자에게 표시되는 상태의 라벨/문자열입니다. 허용되는 최대 길이는 50자(영문 기준)입니다. |
type |
필수: 구매 유형입니다. |
returnsInfo |
주문의 반품 정보입니다. |
fulfillmentInfo |
주문의 처리 정보입니다. |
extension |
판매자와 Google 간에 교환된 모든 추가 필드 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 |
purchaseLocationType |
구매 장소 (매장 / 온라인) |
errors[] |
선택사항: 주문이 거부된 오류입니다. |
PurchaseError
구매주문서가 거부될 수 있는 오류입니다.
JSON 표현 | |
---|---|
{ "type": enum ( |
필드 | |
---|---|
type |
필수: 판매자가 주문을 거부하는 상세한 이유를 나타냅니다. |
description |
추가 오류 설명입니다. |
entityId |
오류에 해당하는 엔티티 ID 예를 들어 LineItemId / ItemOptionId에 해당할 수 있습니다. |
updatedPrice |
PRICE_CHANGED / INORRECT_PRICE 오류 유형인 경우에 적합합니다. |
availableQuantity |
현재 재고 수량이 있습니다. AVAILABILITY_CHANGED의 경우 적용할 수 있습니다. |
TicketOrderExtension
영화, 스포츠 등의 티켓 주문 콘텐츠를 주문하세요.
JSON 표현 | |
---|---|
{
"ticketEvent": {
object ( |
필드 | |
---|---|
ticketEvent |
모든 광고 항목 티켓에 적용되는 이벤트입니다. |
TicketEvent
단일 이벤트를 나타냅니다.
JSON 표현 | |
---|---|
{ "type": enum ( |
필드 | |
---|---|
type |
필수: 티켓 이벤트의 유형입니다(예: 영화, 콘서트). |
name |
필수: 이벤트 이름. 예를 들어 이벤트가 영화인 경우 영화 이름이어야 합니다. |
description |
이벤트 설명입니다. |
url |
이벤트 정보의 URL입니다. |
location |
이벤트가 열리는 위치 또는 조직이 있는 위치입니다. |
eventCharacters[] |
이 이벤트와 관련된 캐릭터입니다. 영화 이벤트의 감독이나 배우 또는 콘서트 공연자 등이 될 수 있습니다. |
startDate |
시작 시간 |
endDate |
종료 시간 |
doorTime |
입장 시간(일정 시작 시간과 다를 수 있음)을 입력합니다. 예를 들어 이벤트가 오전 9시에 시작하지만 입장 시간은 오전 8시 30분입니다. |
EventCharacter
이벤트 캐릭터 1개(예: 주최자, 출연자 등)
JSON 표현 | |
---|---|
{ "type": enum ( |
필드 | |
---|---|
type |
이벤트 캐릭터의 유형입니다(예: 배우 또는 감독). |
name |
사용할 수 있습니다. |
image |
캐릭터의 이미지 |