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

必須: 項目に対して割り当てられた販売者 ID。部分更新を適用する際に既存の項目を識別するために使用されます。最大文字数は 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

任意の型のフィールドを含むオブジェクト。タイプを識別する URI を含むフィールド "@type" を追加できます。例: { "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 またはオファー ID。
quantity

integer

項目の数量。
unitMeasure

object (MerchantUnitMeasure)

単位。選択した単位で項目のサイズを指定します。単位価格を決定するために、有効な価格と一緒にサイズが使用されます。
returnsInfo

object (PurchaseReturnsInfo)

この項目の返品情報。設定しない場合、この項目は注文レベルの返品情報を継承します。
fulfillmentInfo

object (PurchaseFulfillmentInfo)

この項目のフルフィルメント情報。設定しない場合、この項目は注文レベルのフルフィルメント情報を継承します。
itemOptions[]

object (ItemOption)

追加のアドオンまたはサブアイテム。
extension

object

販売者と Google の間で交換される追加フィールド。

任意の型のフィールドを含むオブジェクト。タイプを識別する URI を含むフィールド "@type" を追加できます。例: { "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 または特典 ID。
subOptions[]

object (ItemOption)

他のネストされたサブオプションを定義する場合。

ProductDetails

商品に関する詳細。

JSON 表現 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
フィールド
productId

string

この項目に関連付けられた商品 ID またはオファー ID。
gtin

string

商品の国際取引商品番号。Merchant Center に offerId がない場合に役立ちます。省略可。
plu

string

価格検索コード（一般的に PLU コード、PLU 番号、PLU、生産コード、または生産ラベルと呼ばれる）は、食料品店やスーパーマーケットで大量に販売される農産物を一意に識別する番号のシステムです。
productType

string

販売者が定義した商品カテゴリ。例: 「日用品 > 食料品 > 乳製品、卵 > 牛乳 > 全ミルク」
productAttributes

map (key: string, value: string)

販売者が提供する商品に関する詳細情報。例: { "アレルゲン": "ピーナッツ" }。Merchant Center に 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 の間で交換される追加フィールド。

任意の型のフィールドを含むオブジェクト。タイプを識別する URI を含むフィールド "@type" を追加できます。例: { "id": 1234, "@type": "types.example.com/standard/id" }

StaffFacilitator

サービス担当者に関する情報。

JSON 表現 
{
  "name": string,
  "image": {
    object (Image)
  }
}
フィールド
name

string

担当スタッフの名前。例: 「田中太郎」
image

object (Image)

パフォーマーの画像。