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 표현
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
필드
email

string

사용자 이메일(예: janedoe@gmail.com)입니다.

firstName

string

사용자의 이름입니다.

lastName

string

사용자의 성입니다.

displayName

string

사용자의 표시 이름으로, 성 또는 이름과 다를 수 있습니다.

phoneNumbers[]

object (PhoneNumber)

사용자의 전화번호입니다.

전화번호

표준 전화번호 표현

JSON 표현
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
필드
e164PhoneNumber

string

국제전기통신연합 (ITU) 권장사항 E.164에 정의된 E.164 형식의 전화번호 위키 링크: https://en.wikipedia.org/wiki/E.164

extension

string

확장자는 최대 길이가 40자리인 일련의 숫자로 정의되는 경우를 제외하고는 ITU 권장사항에서 표준화되지 않습니다. 여기서는 확장자 앞에 0이 사용될 수 있음을 수용하기 위해 문자열로 정의됩니다 (정의된 표준이 없으므로 조직은 이를 자유롭게 사용할 수 있음). 숫자가 아닌 기타 다이얼링 문자(예: ,) (대기를 나타냄)가 여기에 저장될 수 있습니다. (예: xxx-xxx-xxxx 내선 번호) 123, '123' 는 확장자입니다.

preferredDomesticCarrierCode

string

국내에서 이 전화번호로 전화를 걸 때 사용할 이동통신사 선택 코드입니다. 여기에는 일부 국가에서 유선전화로 또는 그 반대로 전화를 걸 때 전화를 걸어야 하는 코드도 포함됩니다. 예를 들어 콜롬비아에서 '3'은 휴대전화에서 국내 유선 전화로, 또는 그 반대로 전화를 걸 때 전화번호 앞에 전화를 걸어야 합니다. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

이는 '선호되는' 즉, 다른 코드도 작동할 수 있습니다.

이미지

카드에 표시되는 이미지입니다.

JSON 표현
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
필드
url

string

이미지의 소스 URL입니다. 이미지는 JPG, PNG, GIF (애니메이션 및 정지)를 사용할 수 있습니다. 예를 들면 https://www.agentx.com/logo.png입니다. 필수 항목입니다.

accessibilityText

string

접근성을 위해 사용되는 이미지의 텍스트 설명입니다. 예: 스크린 리더 필수 항목입니다.

height

number

이미지 높이(픽셀 단위)입니다. 선택사항입니다.

width

number

이미지 너비(픽셀 단위)입니다. 선택사항입니다.

판매자

장바구니/주문/항목의 판매자입니다.

JSON 표현
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
필드
id

string

판매자에게 할당된 선택적 ID입니다(있는 경우).

name

string

판매자의 이름(예: '파네라 빵')

image

object (Image)

판매자와 연결된 이미지입니다.

phoneNumbers[]

object (PhoneNumber)

판매자의 전화번호입니다.

address

object (Location)

판매자의 주소입니다.

위치

위치를 나타내는 컨테이너입니다.

JSON 표현
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
필드
coordinates

object (LatLng)

지리적 좌표입니다. [DEVICE_PRECISE_LOCATION] 필요 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 권한을 사용할 수 있습니다

formattedAddress

string

표시 주소(예: '1600 Amphitheatre Pkwy, Mountain View, CA 94043'. [DEVICE_PRECISE_LOCATION] 필요 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 권한을 사용할 수 있습니다

zipCode

string

우편번호. [DEVICE_PRECISE_LOCATION] 필요 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 또는 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 권한이 있는지 확인합니다

city

string

시/군/구. [DEVICE_PRECISE_LOCATION] 필요 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 또는 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 권한이 있는지 확인합니다

postalAddress

object (PostalAddress)

우편 주소입니다. [DEVICE_PRECISE_LOCATION] 필요 [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] 또는 [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] 권한이 있는지 확인합니다

name

string

장소의 이름입니다.

phoneNumber

string

위치의 전화번호입니다. 예: 업체 위치의 연락처 번호 또는 배송 위치의 전화번호

notes

string

위치에 대한 메모입니다.

placeId

string

placeId는 Places API에서 장소의 세부정보를 가져오는 데 사용됩니다. https://developers.google.com/places/web-service/place-id를 참고하세요.

LatLng

위도/경도 쌍을 나타내는 객체입니다. 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않은 한 WGS84 표준을 준수해야 하며, 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.

longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

PostalAddress

우편 주소를 나타냅니다. 예: 우편번호를 입력하세요. 우편 주소가 주어지면 우편 서비스는 사업장(P.O. Box 또는 이와 유사한 제품 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적으로 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터 가져오기를 통해 만들어집니다.

주소 입력 / 수정에 관한 조언: - https://github.com/google/libaddressinput과 같은 i18n 지원 주소 위젯 사용) - 해당 필드가 사용되는 국가 이외의 지역에서 입력란을 입력하거나 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.

이 스키마를 사용하는 방법에 관한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.

JSON 표현
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
필드
revision

number

PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다.

모든 새 버전은 이전 버전과 호환되어야 합니다.

regionCode

string

필수 항목입니다. 주소의 국가/지역의 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 몫입니다. 자세한 내용은 http://cldr.unicode.org/http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참조하세요. 예: 'CH' 되었습니다.

languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (아는 경우). 대개 입력 양식의 UI 언어이거나 주소에 사용된 언어 중 하나와 일치해야 합니다. 국가/지역 또는 음역된 언어로 된 언어입니다. 이는 특정 국가에서 형식에 영향을 줄 수 있지만 데이터의 정확성에 중요하지는 않으며 유효성 검사 또는 기타 형식 지정 이외의 관련 작업에는 영향을 미치지 않습니다.

이 값을 알 수 없는 경우, 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.

postalCode

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 표시해야 하는 것은 아니지만, 우편번호가 사용되는 지역에서는 주소의 다른 부분에 대한 추가 유효성 검사 (예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다.

sortingCode

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용할 경우 값은 'CEDEX'와 같이 선택적으로 뒤에 숫자가 오는 문자열 (예: 'CEDEX 7')이거나 '섹터 코드'를 나타내는 숫자만 사용할 수 있습니다. (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 지표' (예: 코트디부아르)

administrativeArea

string

선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 도, 현을 입력할 수 있습니다. 특히 스페인의 경우 이 지역은 자치지구가 아닌 주입니다 (예: '카탈로니아'가 아닌 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예: 스위스에서는 값을 입력하지 않은 상태로 두어야 합니다.

locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮤, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다.

sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구역이 될 수 있습니다.

addressLines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

addressLines의 값에는 유형 정보가 없고 경우에 따라 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란의 순서는 '봉투 순서'여야 합니다. 주소의 국가/지역입니다. 이것이 다를 수 있는 곳 (예: 일본)에서는 address_language를 사용하여 명시적으로 지정합니다 (예: 큰 단위에서 작은 단위 순서는 'ja', 작은 단위에서 큰 단위 순서는 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 행을 선택할 수 있습니다.

주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 지오코딩을 사용하지 않고도 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 최소한 부분적으로만 해결될 때까지는 주소 구성 요소에 대해 의미론적 추론을 할 수 없습니다.

지역 또는 행정 구역에 해당하는 부분을 추측하는 대신, regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩을 사용하여 완전히 구조화되지 않은 주소를 처리하는 것이 좋습니다.

recipients[]

string

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 'care of'라는 단어와 확인할 수 있습니다

organization

string

선택사항입니다. 주소에 있는 조직의 이름입니다.

목차

광고 항목의 래퍼입니다.

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

object (LineItem)

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

LineItem

광고 항목 1개에 카테고리가 1개 있습니다. 하나의 주문 또는 장바구니에 동일한 카테고리의 광고 항목이 여러 개 있을 수 있습니다. 하위 항목/부가기능 등은 사용 사례에 따라 카테고리 프로토콜로 정의되어야 합니다. 참고: 1. 달리 명시되지 않는 한, 모든 수준의 모든 문자열은 1,000자(영문 기준) 미만이어야 합니다. 2. 달리 명시되지 않는 한, 모든 수준에서 반복되는 모든 필드의 수는 50개 미만이어야 합니다. 3. 지정된 경우 모든 수준의 모든 타임스탬프는 유효한 타임스탬프여야 합니다.

JSON 표현
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
필드
id

string

필수 항목: 판매자가 할당한 광고 항목 식별자입니다. 부분 업데이트를 적용할 때 기존 광고 항목을 식별하는 데 사용됩니다. 최대 허용 길이는 64자(영문 기준)입니다.

name

string

영수증에 표시된 항목의 이름입니다. 최대 허용 길이는 100자(영문 기준)입니다.

userVisibleStateLabel
(deprecated)

string

지원 중단되었습니다. 대신 카테고리 수준의 상태를 사용하세요. 예를 들어 구매의 경우 PurchaseOrderExtension.status를 사용합니다. 이 광고 항목의 상태에 대해 사용자에게 표시되는 라벨입니다.

provider

object (Merchant)

전체 주문과 다른 경우 특정 광고 항목의 제공업체입니다. 예: 광고 항목 제공업체 ANA가 포함된 Expedia 주문

priceAttributes[]

object (PriceAttribute)

광고 항목 수준 가격 및 조정입니다.

followUpActions[]

object (Action)

광고 항목의 후속 조치

recipients[]

object (UserInfo)

광고 항목 수준 고객의 경우 주문 수준 구매자와 다를 수 있습니다. 예: 사용자 X가 사용자 Y의 이름으로 식당을 예약했습니다.

image

object (Image)

이 항목과 연결된 작은 이미지입니다(있는 경우).

description

string

항목 설명입니다.

notes[]

string

이 특정 항목에 적용할 수 있는 추가 참고사항입니다(예: 취소 정책).

disclosures[]

object (Disclosure)

이 광고 항목과 연결된 공개사항입니다.

vertical
(deprecated)

object

지원 중단됨: 카테고리를 대신 사용하세요. 필수: 유형/카테고리에 따른 광고 항목의 의미 체계 콘텐츠 모든 카테고리는 고유한 처리 세부정보를 포함해야 합니다. 다음 값 중 하나여야 합니다. google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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

통합 필드 verticals. 필수: 유형/카테고리에 따른 광고 항목의 의미 체계 콘텐츠 모든 카테고리는 고유한 처리 세부정보를 포함해야 합니다. verticals은 다음 중 하나여야 합니다.
purchase

object (PurchaseItemExtension)

상품, 음식 등의 구매주문서

reservation

object (ReservationItemExtension)

식당, 헤어컷 등의 예약 주문

PriceAttribute

주문 또는 광고 항목의 가격 속성입니다.

JSON 표현
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
필드
type

enum (Type)

필수: 금액 속성 유형.

name

string

필수: 사용자가 표시한 가격 속성의 문자열입니다. 판매자가 보내고 현지화합니다.

state

enum (State)

필수: 가격 상태: 추정치와 실제 가격 비교.

taxIncluded

boolean

가격에 세금이 포함되어 있는지 여부입니다.

통합 필드 spec. 금액 또는 밀리 백분율을 나타냅니다. spec은 다음 중 하나여야 합니다.
amount

object (Money)

금액

amountMillipercentage
(deprecated)

number

백분율의 1/1000까지의 백분율 사양입니다. 예: 8.750% 는 8,750, 음수 백분율은 할인 비율을 나타냅니다. 이 필드의 지원이 중단됩니다. 탄탄한 사용 사례가 필요한 경우 다시 추가하는 것이 좋습니다.

유형

돈의 유형을 나타냅니다.

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않았습니다. 클라이언트는 이 값을 명시적으로 설정할 필요가 없습니다.
REGULAR 할인 등이 적용되기 전의 일반 디스플레이 가격입니다.
DISCOUNT 소계에서 차감됩니다.
TAX 소계에 추가됩니다.
DELIVERY 소계에 추가됩니다.
SUBTOTAL 일부 수수료가 추가될 수 있는 소계입니다.
FEE 추가 '요금'.
GRATUITY 소계에 추가됩니다.
TOTAL 주문 또는 광고 항목의 표시된 가격입니다.

가격 상태를 나타냅니다.

열거형
STATE_UNSPECIFIED 지정되지 않음
ESTIMATE 가격은 추정치입니다.
ACTUAL 사용자에게 청구되는 실제 가격입니다.

Money

해당 통화 유형과 함께 금액을 나타냅니다.

JSON 표현
{
  "currencyCode": string,
  "amountInMicros": string
}
필드
currencyCode

string

ISO 4217에 정의된 3자리 통화 코드입니다.

amountInMicros

string (int64 format)

마이크로 단위의 금액입니다. 예를 들어 $1.99의 경우 이 필드를 1990000으로 설정해야 합니다.

작업

주문 또는 광고 항목과 관련된 후속 작업입니다.

JSON 표현
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
필드
type

enum (Type)

필수: 작업 유형입니다.

title

string

사용자에게 표시되는 작업의 제목 또는 라벨입니다. 최대 허용 길이는 100자(영문 기준)입니다.

openUrlAction

object (OpenUrlAction)

취해야 할 조치

actionMetadata

object (ActionMetadata)

작업과 관련된 메타데이터입니다.

유형

가능한 후속 조치

열거형
TYPE_UNSPECIFIED 지정되지 않은 작업입니다.
VIEW_DETAILS 주문 세부정보 보기 작업입니다.
MODIFY 주문 수정 작업
CANCEL 주문 취소 작업
RETURN 반품 주문 작업입니다.
EXCHANGE 교환 주문 작업입니다.
EMAIL

이메일로 보내기 작업 EMAIL 및 CALL 유형은 지원 중단되었습니다. openUrlAction.url은 전화번호나 이메일로 사용할 수 있습니다.

CALL

통화 작업

REORDER 작업 재정렬
REVIEW 주문 작업을 검토합니다.
CUSTOMER_SERVICE 고객 서비스에 문의하세요.
FIX_ISSUE 문제를 해결하려면 판매자 사이트 또는 앱으로 안내하세요.
DIRECTION 경로 링크입니다.

OpenUrlAction

지정한 URL을 엽니다.

JSON 표현
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
필드
url

string

URL 필드: 다음 중 하나가 될 수 있음: - 앱에 연결된 앱 또는 웹페이지를 열기 위한 http/https URL

androidApp

object (AndroidApp)

Android 앱에서 URL을 처리할 것으로 예상되는 경우 Android 앱에 관한 정보입니다.

urlTypeHint

enum (UrlTypeHint)

URL 유형에 대한 힌트를 나타냅니다.

AndroidApp

처리 제한을 위한 Android 앱 사양

JSON 표현
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
필드
packageName

string

패키지 이름 패키지 이름은 Android 처리를 지정할 때 지정해야 합니다.

versions[]

object (VersionFilter)

여러 필터가 지정된 경우, 일치하는 필터가 있으면 앱이 트리거됩니다.

VersionFilter

앱의 특정 버전이 필요한 경우 VersionFilter를 포함해야 합니다.

JSON 표현
{
  "minVersion": number,
  "maxVersion": number
}
필드
minVersion

number

최소 버전 코드 또는 0(0 포함)

maxVersion

number

최대 버전 코드(해당 값 포함) 고려되는 범위는 [minVersion:maxVersion]입니다. null 범위는 모든 버전을 의미합니다. 예: 단일 버전을 지정하려면 [target_version:target_version]을 사용하세요. 버전을 지정하려면 minVersion 및 maxVersion을 지정하지 않은 상태로 둡니다. maxVersion까지 모든 버전을 지정하려면 minVersion을 지정하지 않은 상태로 둡니다. minVersion에서 모든 버전을 지정하려면 maxVersion을 지정하지 않은 상태로 둡니다.

UrlTypeHint

다양한 유형의 URL 힌트

열거형
URL_TYPE_HINT_UNSPECIFIED 미지정
AMP_CONTENT AMP 콘텐츠로 직접 연결되는 URL 또는 <link rel="amphtml">을 통해 AMP 콘텐츠를 참조하는 표준 URL입니다.

ActionMetadata

작업당 관련 메타데이터입니다.

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

string (Timestamp format)

이 작업이 만료되는 시간입니다.

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

공개 정보

사용자에게 표시될 수 있는 제품, 서비스 또는 정책 공개입니다.

JSON 표현
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
필드
title

string

공개 문구의 제목입니다. 예: '안전 정보'

disclosureText

object (DisclosureText)

공개 내용. 웹링크는 허용됩니다.

presentationOptions

object (DisclosurePresentationOptions)

공개에 대한 표시 옵션입니다.

DisclosureText

웹 링크가 있는 일반 텍스트를 나타냅니다.

JSON 표현
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
필드
template

string

'{0}'와 같은 자리표시자가 포함된 표시할 텍스트 및 '{1}' 텍스트 링크에 삽입되어야 합니다. 예: '경고: 이 제품은 캘리포니아 주에서 암을 유발하는 것으로 알려진 화학 물질에 노출될 수 있습니다. 자세한 내용은 {0}에서 확인하세요." 이 공개 문구에는 홍보성 콘텐츠 또는 광고 콘텐츠를 포함해서는 안 됩니다.

DisclosurePresentationOptions

정보 공개 문구 표시 옵션

JSON 표현
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
필드
presentationRequirement

enum (PresentationRequirement)

공개의 표시 요구사항

initiallyExpanded

boolean

공시 내용을 초기에 확장해야 하는지 여부입니다. 처음에는 기본적으로 접혀 있습니다.

PresentationRequirement

공시 표시 요건

열거형
REQUIREMENT_UNSPECIFIED 요구사항이 지정되지 않았습니다. 명시적으로 설정하면 안 됩니다.
REQUIREMENT_OPTIONAL 정보 공개 문구는 선택사항입니다. 기기가 정보 공개 문구 표시를 지원하지 않는 경우 건너뛸 수 있습니다.
REQUIREMENT_REQUIRED 공개는 필수입니다. 기기에서 정보 공개 문구 표시를 지원하지 않는 경우 대화는 전화로 펀트됩니다.

PurchaseItemExtension

구매 카테고리의 항목 콘텐츠입니다.

JSON 표현
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
필드
status

enum (PurchaseStatus)

필수: 광고 항목 수준 상태입니다.

userVisibleStatusLabel

string

필수: 사용자가 볼 수 있는 상태 라벨/문자열 최대 허용 길이는 50자(영문 기준)입니다.

type

enum (PurchaseType)

필수: 구매 유형입니다.

productId
(deprecated)

string

이 광고 항목과 연결된 제품 또는 혜택 ID입니다.

quantity

number

상품의 수량입니다.

unitMeasure

object (MerchantUnitMeasure)

단위 측정. 선택한 단위로 항목의 크기를 지정합니다. 활성 가격과 함께 크기를 사용하여 단가를 결정합니다.

returnsInfo

object (PurchaseReturnsInfo)

이 광고 항목의 정보를 반환합니다. 설정하지 않으면 이 광고 항목은 주문 수준 반품 정보를 상속합니다.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

이 광고 항목의 처리 정보입니다. 설정하지 않으면 이 광고 항목은 주문 수준의 처리 정보를 상속합니다.

itemOptions[]

object (ItemOption)

추가 부가기능 또는 하위 항목

extension

object

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

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

productDetails

object (ProductDetails)

제품 세부정보입니다.

PurchaseStatus

구매주문서 또는 특정 항목과 연관된 구매 상태입니다.

열거형
PURCHASE_STATUS_UNSPECIFIED 상태가 지정되지 않았습니다.
READY_FOR_PICKUP 수령 준비 완료
SHIPPED 발송됨.
DELIVERED 전송 완료.
OUT_OF_STOCK 재고가 없습니다.
IN_PREPARATION 'IN_PREPARATION' 다른 맥락에서 다른 의미를 가질 수 있습니다 음식 주문의 경우 음식이 준비되는 중일 수 있습니다. 소매업의 경우 상품이 포장되고 있을 수 있습니다.
CREATED 주문이 생성되었습니다.
CONFIRMED 판매자가 주문을 확인했습니다.
REJECTED 판매자가 주문 또는 항목을 거부했습니다.
RETURNED 사용자가 상품을 반품했습니다.
CANCELLED 사용자가 주문 또는 항목을 취소했습니다.
CHANGE_REQUESTED 사용자가 주문 변경을 요청했으며 통합업체에서 이 변경사항을 처리하는 중입니다. 요청이 처리된 후 주문이 다른 상태로 이동되어야 합니다.

PurchaseType

구매 카테고리입니다.

열거형
PURCHASE_TYPE_UNSPECIFIED 알 수 없는 값입니다.
RETAIL 실제 상품과 같은 구매가 포함됩니다.
FOOD 음식 주문 구매가 포함됩니다.
GROCERY 식료품 구매.
MOBILE_RECHARGE 선불 모바일 충전 구매

MerchantUnitMeasure

판매자 단가 책정 단위입니다.

JSON 표현
{
  "measure": number,
  "unit": enum (Unit)
}
필드
measure

number

값: 예 1.2.

unit

enum (Unit)

단위: POUND, GRAM 예

단위

열거형
UNIT_UNSPECIFIED 단위가 지정되지 않았습니다.
MILLIGRAM 밀리그램.
GRAM 할머니.
KILOGRAM 킬로그램
OUNCE 운스.
POUND 파운드.

PurchaseReturnsInfo

주문 또는 특정 광고 항목과 연결된 정보를 반환합니다.

JSON 표현
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
필드
isReturnable

boolean

true인 경우 반환이 허용됩니다.

daysToReturn

number

해당 일수 내에는 반품이 허용됩니다.

policyUrl

string

반품 정책 링크

PurchaseFulfillmentInfo

구매주문서 또는 특정 항목과 연결된 처리 정보입니다.

JSON 표현
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
필드
id

string

이 서비스 옵션의 고유 식별자입니다.

fulfillmentType

enum (Type)

필수: 처리 유형

expectedFulfillmentTime

object (Time)

기간이 지정된 경우에는 기간으로, 단일 시간이 지정된 경우에는 도착예정시간입니다. 예상 배송 또는 수령 시간입니다.

expectedPreparationTime

object (Time)

기간이 지정된 경우에는 기간으로, 단일 시간이 지정된 경우에는 도착예정시간입니다. 음식을 준비하는 데 걸리는 예상 시간입니다. 1회만 권장됩니다.

location

object (Location)

수령 또는 배송 위치

expireTime

string (Timestamp format)

이 처리 옵션이 만료되는 시간입니다.

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

price

object (PriceAttribute)

이 옵션의 비용입니다.

fulfillmentContact

object (UserInfo)

이 처리를 위한 사용자 연락처입니다.

shippingMethodName

string

사용자가 선택한 배송 방법의 이름입니다.

storeCode

string

위치의 상점 코드입니다. 예: Walmart는 판매자이고 storeCode는 처리가 발생한 월마트 매장입니다. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

주문이 선택되는 방법에 관한 추가 정보입니다. 이 필드는 처리 유형이 PICKUP인 경우에만 적용됩니다.

유형

처리 유형입니다.

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
DELIVERY 이 주문 상품은 배송될 예정입니다.
PICKUP 이 주문은 수령해야 합니다.

시간

사용자에게 주문을 표시할 때 사용할 이벤트의 시간을 나타내는 시간 구성입니다.

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

string

예약 시간, 배송 시간 등과 같은 주문 이벤트 시간을 나타냅니다. 기간 (시작 및 종료 시간), 날짜, 날짜 시간 등이 될 수 있습니다. 지원되는 모든 형식은 https://en.wikipedia.org/wiki/ISO_8601을 참고하세요.

PickupInfo

주문 상품을 수령하는 방법에 관한 세부정보입니다. 여기에는 수령 유형 등의 세부정보와 각 유형에 첨부된 추가 메타데이터(있는 경우)가 포함됩니다.

JSON 표현
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
필드
pickupType

enum (PickupType)

수령 방법(예: 매장 내부, 매장 밖 수령)

curbsideInfo

object (CurbsideInfo)

매장 밖 수령과 관련된 세부정보입니다. pickupType이 'CURBSIDE'가 아니면 이 필드는 무시됩니다.

checkInInfo[]

object (CheckInInfo)

체크인을 지원하기 위해 파트너가 지원하는 다양한 방법의 목록입니다.

PickupType

지원되는 승차 유형 목록입니다.

열거형
UNSPECIFIED 수령 유형이 지정되지 않았습니다.
INSTORE 식당 안에서 음식을 픽업합니다.
CURBSIDE 레스토랑 외부의 지정된 장소에 차량을 주차하면 누군가가 그곳에서 음식을 배달합니다.

CurbsideInfo

매장 밖 주문을 지원하는 방법에 대한 세부정보입니다.

JSON 표현
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
필드
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

매장 밖 수령 주문을 용이하게 하려면 파트너에게 추가 정보가 필요합니다. 선택된 처리 유형에 따라 사용자로부터 관련 세부정보가 수집됩니다.

userVehicle

object (Vehicle)

주문한 사용자의 차량 세부정보입니다.

CurbsideFulfillmentType

매장 밖 수령 유형의 가능한 값

열거형
UNSPECIFIED 매장 밖 재고 위치 유형이 지정되지 않았습니다.
VEHICLE_DETAIL 매장 밖 수령을 용이하게 하려면 차량 세부정보가 필요합니다.

차량

차량 세부정보

JSON 표현
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
필드
make

string

차량 제조업체 (예: '혼다') 사용자에게 표시되며 현지화해야 합니다. 필수 항목입니다.

model

string

차량 모델 (예: 'Grom') 사용자에게 표시되며 현지화해야 합니다. 필수 항목입니다.

licensePlate

string

차량 번호판 번호 (예: '1ABC234') 필수 항목입니다.

colorName

string

차량 색상 이름입니다. 예: Black(선택사항)

image

object (Image)

차량 사진의 URL입니다. 사진은 약 256x256픽셀로 표시됩니다. jpg 또는 png 형식이어야 합니다. 선택사항입니다.

CheckInInfo

파트너가 체크인 방법을 지원하기 위해 요구하는 메타데이터입니다.

JSON 표현
{
  "checkInType": enum (CheckInType)
}
필드
checkInType

enum (CheckInType)

체크인 안내를 보내는 데 사용되는 메서드입니다.

CheckInType

체크인 안내를 보내는 데 사용되는 다양한 방법입니다.

열거형
CHECK_IN_TYPE_UNSPECIFIED 알 수 없는 값입니다.
EMAIL 체크인 정보는 이메일로 전송됩니다.
SMS 체크인 정보는 SMS로 전송됩니다.

ItemOption

부가기능 또는 하위 항목을 나타냅니다.

JSON 표현
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
필드
id

string

상품 옵션의 경우 고유 상품 ID입니다.

name

string

옵션 이름입니다.

prices[]

object (PriceAttribute)

옵션 총 가격입니다.

note

string

옵션과 관련된 참고사항입니다.

quantity

number

항목인 경우 수량을 선택합니다.

productId

string

이 옵션과 연결된 제품 또는 혜택 ID입니다.

subOptions[]

object (ItemOption)

다른 중첩된 하위 옵션을 정의하려는 경우

ProductDetails

제품 세부정보입니다.

JSON 표현
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
필드
productId

string

이 광고 항목과 연결된 제품 또는 혜택 ID입니다.

gtin

string

제품의 국제거래단품식별코드입니다. 판매자 센터에 offerId가 없는 경우에 유용합니다. 선택사항입니다.

plu

string

일반적으로 PLU 코드, PLU 번호, PLU, 농산물 코드 또는 제품 라벨이라고 하는 가격 조회 코드는 식료품점과 슈퍼마켓에서 판매되는 대량 제품을 고유하게 식별하는 숫자 시스템입니다.

productType

string

판매자가 정의한 제품 카테고리입니다. 예: "홈 > 식료품 > 유제품 및 달걀 > 우유 > 전유"

productAttributes

map (key: string, value: string)

판매자가 제공한 제품 세부정보(예: { &quot;allergen&quot;: &quot;peanut&quot; } 판매자 센터에 offerId가 없는 경우에 유용합니다. 선택사항입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ReservationItemExtension

식당, 헤어컷 등의 예약 주문에 대한 항목 콘텐츠입니다. 다음 ID: 15.

JSON 표현
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
필드
status

enum (ReservationStatus)

필수: 예약 상태

userVisibleStatusLabel

string

필수: 사용자가 볼 수 있는 상태 라벨/문자열 최대 허용 길이는 50자(영문 기준)입니다.

type

enum (ReservationType)

예약 유형입니다. 적용할 수 있는 유형 옵션이 없는 경우 설정 해제할 수 있습니다.

reservationTime

object (Time)

서비스/이벤트가 발생하도록 예약된 시간입니다. 시간 범위, 날짜 또는 정확한 날짜일 수 있습니다.

userAcceptableTimeRange

object (Time)

사용자가 허용되는 기간입니다.

confirmationCode

string

이 예약의 확인 코드입니다.

partySize

number

인원수입니다.

staffFacilitators[]

object (StaffFacilitator)

예약 서비스를 제공할 교직원 안내 직원입니다. 예: 미용사

location

object (Location)

서비스/이벤트의 위치입니다.

extension

object

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

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

ReservationStatus

예약의 상태입니다.

열거형
RESERVATION_STATUS_UNSPECIFIED 상태가 지정되지 않았습니다.
PENDING 예약이 대기 중입니다.
CONFIRMED 예약이 확인되었습니다.
CANCELLED 사용자가 예약을 취소했습니다.
FULFILLED 예약이 완료되었습니다.
CHANGE_REQUESTED 예약 변경이 요청됨
REJECTED 예약이 만료되었거나 통합업체에 의해 거부되었습니다.

ReservationType

예약 유형입니다.

열거형
RESERVATION_TYPE_UNSPECIFIED 알 수 없는 유형.
RESTAURANT 식당 예약.
HAIRDRESSER 미용사 예약.

StaffFacilitator

서비스 담당자에 대한 정보입니다.

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

string

교직원 강사의 이름입니다. 예: "존 스미스"

image

object (Image)

공연자의 이미지

PaymentData

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

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

object (PaymentResult)

통합업체가 거래를 완료하는 데 사용하는 결제 결과입니다. Actions-on-Google에서 결제 환경을 관리하는 경우 Actions on 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,
  "paymentMethodVoiceName": string
}
필드
paymentType

enum (PaymentType)

결제 유형입니다.

paymentMethodDisplayName

string

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

paymentMethodVoiceName

string

음성 전용 어시스턴트 기기의 경우 사용자에게 음성으로 안내할 결제 수단 이름입니다. 예: '1234로 끝나는 비자' 또는 '5678로 끝나는 당좌예금 계좌' 참고: 음성 전용 어시스턴트 기기의 경우 paymentMethodDisplayName 대신 사용되는 음성 최적화 문자열입니다. 이 문자열이 설정되지 않으면 paymentMethodDisplayName이 사용자에게 음성으로 제공됩니다.

PaymentType

PaymentType은 판매자가 제공한 결제 수단에 사용된 결제 수단을 나타냅니다. 작업은 결제 수단의 표시 이름도 제공해야 합니다.

열거형
PAYMENT_TYPE_UNSPECIFIED 결제 유형이 지정되지 않았습니다.
PAYMENT_CARD 신용카드/체크카드 또는 선불카드
BANK 결제 수단이 은행 계좌임
LOYALTY_PROGRAM 결제 수단이 포인트 제도입니다.
CASH 결제 수단이 현금입니다.
GIFT_CARD 결제 수단이 기프트 카드임
WALLET 서드 파티 월렛(예: PayPal)

PaymentMethodProvenance

거래에 사용된 결제 수단 출처를 나타냅니다.

열거형
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED 출처가 지정되지 않았습니다.
PAYMENT_METHOD_PROVENANCE_GOOGLE 출처는 Google입니다.
PAYMENT_METHOD_PROVENANCE_MERCHANT 출처는 판매자입니다.

프로모션

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

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)

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

PurchaseLocationType

구매의 위치 유형입니다.

열거형
UNSPECIFIED_LOCATION 알 수 없는 값입니다.
ONLINE_PURCHASE 온라인에서 구매한 모든 상품입니다.
INSTORE_PURCHASE 모든 매장 구매

PurchaseError

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

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

enum (ErrorType)

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

description

string

추가 오류 설명입니다.

entityId

string

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

updatedPrice

object (PriceAttribute)

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

availableQuantity

number

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

ErrorType

가능한 오류 유형

열거형
ERROR_TYPE_UNSPECIFIED 알 수 없는 오류
NOT_FOUND 항목을 찾을 수 없습니다(항목, FulfillmentOption, 프로모션일 수 있음). 엔티티 ID는 필수 항목입니다.
INVALID 항목 데이터가 잘못되었습니다. Item, FulfillmentOption, 프로모션일 수 있습니다. 엔티티 ID는 필수 항목입니다.
AVAILABILITY_CHANGED 사용할 수 없는 상품 또는 요청을 처리하기에 상품이 부족합니다. 엔티티 ID는 필수 항목입니다.
PRICE_CHANGED 상품 가격이 상품 항목의 가격과 다릅니다. 엔티티 ID 및 업데이트된 가격이 필요합니다.
INCORRECT_PRICE 수수료, 합계의 가격 오류 엔티티 ID 및 업데이트된 가격이 필요합니다.
REQUIREMENTS_NOT_MET 주문 수락을 위한 제약 조건이 충족되지 않음 - 최소 장바구니 크기 등
TOO_LATE FulfillmentOption이 만료되었습니다.
NO_CAPACITY 사용 가능한 서비스 용량이 없습니다.
INELIGIBLE 사용자가 주문할 수 없습니다 (블랙리스트에 포함됨).
OUT_OF_SERVICE_AREA 경계 규칙 등으로 인해 요청한 주소로 배송할 수 없습니다.
CLOSED 음식점은 주문 시간에 영업을 하지 않습니다.
PROMO_NOT_APPLICABLE 아래에 해당하는 항목이 없는 경우 프로모션 코드 적용에 실패한 모든 사례를 포착하는 일반 오류 코드입니다. 엔티티 ID로 프로모션 코드를 추가합니다.
PROMO_NOT_RECOGNIZED 파트너가 쿠폰 코드를 인식하지 못했습니다. 엔티티 ID로 프로모션 코드를 추가합니다.
PROMO_EXPIRED 프로모션이 만료되어 적용할 수 없습니다. 엔티티 ID로 프로모션 코드를 추가합니다.
PROMO_USER_INELIGIBLE 현재 사용자는 이 쿠폰을 사용할 수 없습니다. 엔티티 ID로 프로모션 코드를 추가합니다.
PROMO_ORDER_INELIGIBLE 현재 주문에는 이 쿠폰을 사용할 수 없습니다. 엔티티 ID로 프로모션 코드를 추가합니다.
UNAVAILABLE_SLOT 미리 주문 슬롯을 사용할 수 없습니다.
FAILED_PRECONDITION 주문 수락을 위한 제약 조건 미충족 - 최소 장바구니 크기 등
PAYMENT_DECLINED 결제가 잘못되었습니다.
MERCHANT_UNREACHABLE 판매자에게 연락할 수 없습니다. 이는 파트너가 애그리게이터인데 판매자에게 도달할 수 없는 경우에 유용합니다.

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분입니다.

유형

이벤트 유형입니다.

열거형
EVENT_TYPE_UNKNOWN 알 수 없는 이벤트 유형입니다.
MOVIE 영화를 탭합니다.
CONCERT 콘서트.
SPORTS 스포츠.

EventCharacter

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

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

enum (Type)

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

name

string

캐릭터의 이름입니다.

image

object (Image)

캐릭터의 이미지

유형

문자 유형입니다.

열거형
TYPE_UNKNOWN 알 수 없는 유형입니다.
ACTOR 작업 수행자.
PERFORMER 공연자
DIRECTOR 디렉터
ORGANIZER 주최자.