ProposedOrder

呼叫者要求使用者確認的訂單。

JSON 表示法
{
  "id": string,
  "cart": {
    object(Cart)
  },
  "otherItems": [
    {
      object(LineItem)
    }
  ],
  "image": {
    object(Image)
  },
  "termsOfServiceUrl": string,
  "totalPrice": {
    object(Price)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
欄位
id

string

這個提案訂單的選用 ID。包含在確認時退回整合商的 ProposedOrder 中。

cart

object(Cart)

使用者的項目。

otherItems[]

object(LineItem)

費用、調整項、小計等

image

object(Image)

與建議訂單相關聯的圖片。

termsOfServiceUrl

string

此提案訂單適用的服務條款連結。

totalPrice

object(Price)

建議訂單的總價。如果為 ACTUAL 類型,這是指使用者確認建議訂單時,呼叫端要支付的金額。

extension

object

根據訂單類型延伸建議訂單的內容。舉例來說,如果訂單包含地點,這類額外資訊就會包含 OrderLocation 值。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。例如:{ "id": 1234, "@type": "types.example.com/standard/id" }.

購物車

使用者想要的商品購物車。

JSON 表示法
{
  "id": string,
  "merchant": {
    object(Merchant)
  },
  "lineItems": [
    {
      object(LineItem)
    }
  ],
  "otherItems": [
    {
      object(LineItem)
    }
  ],
  "notes": string,
  "promotions": [
    {
      object(Promotion)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
欄位
id

string

此購物車的選填 ID。包含在確認時,包含在購物車內並退回整合商的物品。

merchant

object(Merchant)

購物車商家 (如與呼叫端不同)。

lineItems[]

object(LineItem)

使用者訂購的商品或服務。至少必須有一個委刊項。

otherItems[]

object(LineItem)

使用者輸入的調整項,例如:免付費。

notes

string

關於此購物車的附註。

promotions[]

object(Promotion)

選用設定。促銷優待券已新增至購物車。符合資格的促銷活動將以折扣委刊項的形式退回建議訂單。

extension

object

根據訂單類型將商品延長至購物車。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。例如:{ "id": 1234, "@type": "types.example.com/standard/id" }.

商家

購物車商家。

JSON 表示法
{
  "id": string,
  "name": string
}
欄位
id

string

商家的 ID。

name

string

向使用者顯示的商家名稱。這是必要項目。

LineItem

訂單中的委刊項。

JSON 表示法
{
  "id": string,
  "name": string,
  "type": enum(LineItemType),
  "quantity": number,
  "description": string,
  "image": {
    object(Image)
  },
  "price": {
    object(Price)
  },
  "subLines": [
    {
      object(SubLine)
    }
  ],
  "offerId": string,
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
欄位
id

string

購物車/訂單中的商品專屬 ID。這是必要項目。

name

string

收據中顯示的明細項目名稱。這是必要項目。

type

enum(LineItemType)

委刊項類型。

quantity

number

包含的項目數量。

description

string

商品的說明。

image

object(Image)

與此項目相關聯的小型圖片。

price

object(Price)

每個委刊項都必須設定價格,即使價格為 0 也一樣。必要欄位。這是本行收據上顯示的總價 (即單位價格 * 數量)。

subLines[]

object(SubLine)

子委刊項。只有在類型為 REGULAR 時才有效。

offerId

string

這項商品的選填產品或優惠 ID。

extension

object

根據類型決定委刊項的額外資訊。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。例如:{ "id": 1234, "@type": "types.example.com/standard/id" }.

SubLine

與訂單中委刊項相關聯的子委刊項。

JSON 表示法
{

  // Union field subline can be only one of the following:
  "lineItem": {
    object(LineItem)
  },
  "note": string
  // End of list of possible types for union field subline.
}
欄位
聯集欄位 subline。子委刊項。subline 只能是下列其中一項:
lineItem

object(LineItem)

一般委刊項 (例如外掛程式)。

note

string

與委刊項相關的附註。

宣傳

已將促銷活動加入購物車。

JSON 表示法
{
  "coupon": string
}
欄位
coupon

string

必要欄位。第三方瞭解優待券代碼。例如:GOOGLE10。