LineItem

Một mục hàng chứa một ngành dọc. Một đơn đặt hàng hoặc giỏ hàng có thể có nhiều mục hàng thuộc cùng một ngành dọc. Các mục hàng phụ/tiện ích bổ sung, v.v. nên được xác định trong protos ngành dọc tuỳ thuộc vào trường hợp sử dụng của chúng. Lưu ý: 1. Tất cả các chuỗi ở tất cả cấp phải ít hơn 1000 ký tự trừ khi có quy định khác. 2. Tất cả các trường lặp lại ở tất cả các cấp phải nhỏ hơn 50 số đếm trừ khi có quy định khác. 3. Tất cả dấu thời gian ở tất cả các cấp, nếu được chỉ định, phải là dấu thời gian hợp lệ.

Biểu diễn dưới dạng 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.
}
Các trường
id

string

Bắt buộc: Giá trị nhận dạng do người bán chỉ định cho mục hàng. Dùng để xác định mục hàng hiện có khi áp dụng nội dung cập nhật một phần. Độ dài tối đa cho phép là 64 ký tự.
name

string

tên của mục hàng như hiển thị trên biên nhận. Độ dài tối đa cho phép là 100 ký tự.
userVisibleStateLabel
(deprecated)

string

Không dùng nữa. Thay vào đó, hãy sử dụng trạng thái cấp dọc. Ví dụ: đối với giao dịch mua, hãy sử dụng PurchaseOrderExtension.status. Nhãn mà người dùng nhìn thấy cho trạng thái của mục hàng này.
provider

object (Merchant)

Nhà cung cấp mục hàng cụ thể, nếu khác với đơn đặt hàng tổng thể. Ví dụ: Đơn đặt hàng Expedia với nhà cung cấp mục hàng ANA.
priceAttributes[]

object (PriceAttribute)

Giá và mức điều chỉnh ở cấp mục hàng.
followUpActions[]

object (Action)

Các hành động tiếp theo tại mục hàng.
recipients[]

object (UserInfo)

Khách hàng ở cấp mục hàng, khách hàng có thể khác với người mua cấp Đơn đặt hàng. Ví dụ: Người dùng X đã đặt chỗ tại nhà hàng dưới tên của người dùng Y.
image

object (Image)

Hình ảnh nhỏ liên kết với mục này, nếu có.
description

string

Nội dung mô tả mục hàng.
notes[]

string

Ghi chú bổ sung áp dụng cho mục hàng cụ thể này, chẳng hạn như chính sách huỷ.
disclosures[]

object (Disclosure)

Thông tin công bố liên quan đến mục hàng này.
vertical
(deprecated)

object

Ngừng sử dụng: Sử dụng ngành dọc. Bắt buộc: Nội dung ngữ nghĩa của mục hàng dựa trên loại/ngành dọc. Mỗi ngành dọc phải có thông tin thực hiện riêng. Phải là một trong các giá trị sau: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
Trường nhóm verticals. Bắt buộc: Nội dung ngữ nghĩa của mục hàng dựa trên loại/ngành dọc. Mỗi ngành dọc phải có thông tin thực hiện riêng. verticals chỉ có thể là một trong những trạng thái sau đây:
purchase

object (PurchaseItemExtension)

Các đơn đặt hàng như hàng hoá, thực phẩm, v.v.
reservation

object (ReservationItemExtension)

Các đơn đặt hàng trước như nhà hàng, cắt tóc, v.v.

PurchaseItemExtension

Nội dung mục hàng của Ngành dọc mua hàng.

Biểu diễn dưới dạng 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)
  }
}
Các trường
status

enum (PurchaseStatus)

Bắt buộc: Trạng thái cấp mục hàng.
userVisibleStatusLabel

string

Bắt buộc: Chuỗi/nhãn mà người dùng nhìn thấy cho trạng thái. Độ dài tối đa cho phép là 50 ký tự.
type

enum (PurchaseType)

Bắt buộc: loại giao dịch mua.
productId
(deprecated)

string

Mã sản phẩm hoặc mã ưu đãi được liên kết với mục hàng này.
quantity

integer

Số lượng của mặt hàng.
unitMeasure

object (MerchantUnitMeasure)

Đơn vị đo lường. Chỉ định kích thước của mặt hàng theo các đơn vị đã chọn. Kích thước cùng với giá đang áp dụng được dùng để xác định đơn giá.
returnsInfo

object (PurchaseReturnsInfo)

Thông tin trả về của mục hàng này. Nếu bạn không đặt chính sách này, thì mục hàng này sẽ kế thừa thông tin trả về ở cấp đơn đặt hàng.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Thông tin thực hiện đơn hàng cho mục hàng này. Nếu bạn không đặt chính sách này, thì mục hàng này sẽ kế thừa thông tin thực hiện ở cấp đơn đặt hàng.
itemOptions[]

object (ItemOption)

Tiện ích bổ sung hoặc mục phụ bổ sung.
extension

object

Mọi trường bổ sung được trao đổi giữa người bán và Google.

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
productDetails

object (ProductDetails)

Thông tin chi tiết về sản phẩm.

MerchantUnitMeasure

Số lượng đo lường để định giá theo đơn vị của người bán.

Biểu diễn dưới dạng JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
Các trường
measure

number

Giá trị: Ví dụ 1.2.
unit

enum (Unit)

Đơn vị: Ví dụ về POUND, GRAM.

ItemOption

Đại diện cho các tiện ích bổ sung hoặc mục phụ.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Các trường
id

string

Đối với các lựa chọn là mặt hàng, mã mặt hàng duy nhất.
name

string

Tên lựa chọn.
prices[]

object (PriceAttribute)

Tổng giá cho lựa chọn.
note

string

Ghi chú liên quan đến lựa chọn này.
quantity

integer

Đối với các lựa chọn là mặt hàng, hãy chọn số lượng.
productId

string

Mã sản phẩm hoặc mã ưu đãi liên kết với lựa chọn này.
subOptions[]

object (ItemOption)

Để xác định các tuỳ chọn phụ lồng nhau khác.

ProductDetails

Thông tin chi tiết về sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Các trường
productId

string

Mã sản phẩm hoặc mã ưu đãi được liên kết với mục hàng này.
gtin

string

Mã số sản phẩm thương mại toàn cầu của sản phẩm. Hữu ích nếu offerId không có trong Merchant Center. Không bắt buộc.
plu

string

Mã tra cứu giá (thường được gọi là mã PLU, số PLU, PLU, mã sản phẩm hoặc nhãn sản phẩm) là một hệ thống số giúp xác định riêng từng sản phẩm bán theo số lượng lớn tại các cửa hàng tạp hoá và siêu thị.
productType

string

Danh mục sản phẩm do người bán xác định. Ví dụ: "Trang chủ > Hàng tạp hoá > Sữa và trứng > Sữa > Sữa nguyên chất"
productAttributes

map (key: string, value: string)

Do người bán cung cấp thông tin chi tiết về sản phẩm, ví dụ: { "allergen": "peanut" }. Hữu ích nếu offerId không có trong Merchant Center. Không bắt buộc.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Nội dung mục hàng cho các đơn đặt hàng đặt trước như nhà hàng, cắt tóc, v.v. Mã tiếp theo: 15.

Biểu diễn dưới dạng 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: ...,
    ...
  }
}
Các trường
status

enum (ReservationStatus)

Bắt buộc: Trạng thái đặt trước.
userVisibleStatusLabel

string

Bắt buộc: Chuỗi/nhãn mà người dùng nhìn thấy cho trạng thái. Độ dài tối đa cho phép là 50 ký tự.
type

enum (ReservationType)

một loại đặt trước. Bạn có thể không đặt chính sách này nếu không có lựa chọn loại nào phù hợp.
reservationTime

object (Time)

thời gian dịch vụ/sự kiện được lên lịch diễn ra. Có thể là phạm vi thời gian, ngày hoặc giờ ngày chính xác.
userAcceptableTimeRange

object (Time)

phạm vi thời gian mà người dùng có thể chấp nhận.
confirmationCode

string

Mã xác nhận cho yêu cầu đặt chỗ này.
partySize

integer

Số người.
staffFacilitators[]

object (StaffFacilitator)

Nhân viên hỗ trợ sẽ phục vụ yêu cầu đặt chỗ. Ví dụ: Thợ làm tóc.
location

object (Location)

Địa điểm của dịch vụ/sự kiện.
extension

object

Mọi trường bổ sung được trao đổi giữa người bán và Google.

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

StaffFacilitator

Thông tin về nhân viên bảo dưỡng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
Các trường
name

string

Tên của người hỗ trợ nhân viên. Ví dụ: "John Smith"
image

object (Image)

Hình ảnh của người biểu diễn.