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. Bạn nên xác định các mục hàng phụ/tiện ích bổ sung, v.v. trong các giao thức dọc tuỳ thuộc vào trường hợp sử dụng. Lưu ý: 1. Tất cả chuỗi ở mọi cấp độ phải nhỏ hơn 1000 ký tự trừ phi có quy định khác. 2. Số lượng trường lặp lại ở tất cả các cấp phải nhỏ hơn 50, trừ phi có quy định khác. 3. Tất cả dấu thời gian ở mọi 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.
}
Trường
id

string

Bắt buộc: Giá trị nhận dạng được chỉ định cho người bán 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ư được 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àng, hãy sử dụng PurchaseOrderExtension.status. Nhãn hiển thị cho người dùng về 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 trên Expedia có 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)

Hành động theo dõi tại mục hàng.
recipients[]

object (UserInfo)

Khách hàng cấp mục hàng, thông tin này 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 theo tên của người dùng Y.
image

object (Image)

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

string

Mô tả mục hàng.
notes[]

string

Các lưu ý bổ sung áp dụng cho mục hàng cụ thể này, ví dụ: 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

Không dùng nữa: 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 của mục hàng. Mỗi ngành dọc nên bao gồm thông tin chi tiết về việc thực hiện đơn hàng 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

Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung "@type" chứa URI xác định kiểu. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
Trường kết hợp 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 của mục hàng. Mỗi ngành dọc nên bao gồm thông tin chi tiết về việc thực hiện đơn hàng 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)

Đặt chỗ 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)
  }
}
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: Nhãn/chuỗi 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 ưu đãi 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)

Số lượng đo lường đơn vị. Chỉ định kích thước của mặt hàng theo đơn vị đã chọn. Kích thước cùng với giá đang được sử 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, 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, mục hàng này sẽ kế thừa thông tin về việc thực hiện đơn đặt hàng ở 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.

Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung "@type" chứa URI xác định kiểu. 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)
}
Trường
measure

number

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

enum (Unit)

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

ItemOption

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

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)
    }
  ]
}
Trường
id

string

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

string

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

object (PriceAttribute)

Tổng giá của 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, số lượng.
productId

string

Mã sản phẩm hoặc ư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,
    ...
  }
}
Trường
productId

string

Mã sản phẩm hoặc ưu đãi 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 biệt các 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ản phẩm từ sữa và Trứng > Sữa > Sữa nguyên chất"
productAttributes

map (key: string, value: string)

Thông tin chi tiết về sản phẩm do người bán cung cấp, 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: ...,
    ...
  }
}
Trường
status

enum (ReservationStatus)

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

string

Bắt buộc: Nhãn/chuỗi 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)

loại đặt chỗ trước. Bạn có thể không đặt được nếu không áp dụng được bất kỳ loại nào.
reservationTime

object (Time)

thời điểm 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 tháng hoặc ngày giờ chính xác.
userAcceptableTimeRange

object (Time)

chấp nhận được với người dùng.
confirmationCode

string

Mã xác nhận cho lượt đặt chỗ này.
partySize

integer

Số lượng người.
staffFacilitators[]

object (StaffFacilitator)

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

object (Location)

Vị trí 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.

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

StaffFacilitator

Thông tin về nhân viên cung cấp dịch vụ.

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

string

Tên của người điều phối là nhân viên. Ví dụ: "John Smith"
image

object (Image)

Hình ảnh của người thực hiện.