LineItem

광고 항목 1개에 카테고리 1개가 포함됩니다. 주문 또는 장바구니에 동일한 카테고리의 여러 광고 항목이 포함될 수 있습니다. 하위 항목/부가기능 등은 사용 사례에 따라 카테고리 proto에서 정의해야 합니다. 참고: 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의 익스피디아 주문

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)

공연자의 이미지