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)

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

PurchaseItemExtension

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

JSON 표현 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "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

integer

상품의 수량입니다.
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)

제품 세부정보입니다.

MerchantUnitMeasure

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

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

number

값: 예 1.2.
unit

enum (Unit)

단위: POUND, GRAM 예

ItemOption

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

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

string

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

string

옵션 이름입니다.
prices[]

object (PriceAttribute)

옵션 총 가격입니다.
note

string

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

integer

항목인 경우 수량을 선택합니다.
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)

판매자가 제공한 제품 세부정보(예: { "allergen": "peanut" } 판매자 센터에 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": integer,
  "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

integer

인원수입니다.
staffFacilitators[]

object (StaffFacilitator)

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

object (Location)

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

object

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

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

StaffFacilitator

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

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

string

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

object (Image)

공연자의 이미지