- Biểu diễn dưới dạng JSON
- PurchaseItemExtension (Tiện ích mở rộng mặt hàng)
- MerchantUnitMeasure
- ItemOption
- ProductDetails
- ReservationItemExtension (Phần mở rộng đặt trước)
- StaffFacilitator
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 ( |
Các trường | ||
---|---|---|
id |
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 |
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 |
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 |
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[] |
Giá và mức điều chỉnh ở cấp mục hàng. |
|
followUpActions[] |
Các hành động tiếp theo tại mục hàng. |
|
recipients[] |
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 |
Hình ảnh nhỏ liên kết với mục này, nếu có. |
|
description |
Nội dung mô tả mục hàng. |
|
notes[] |
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[] |
Thông tin công bố liên quan đến mục hàng này. |
|
vertical |
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: Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |
|
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 |
Các đơn đặt hàng như hàng hoá, thực phẩm, v.v. |
|
reservation |
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 ( |
Các trường | |
---|---|
status |
Bắt buộc: Trạng thái cấp mục hàng. |
userVisibleStatusLabel |
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 |
Bắt buộc: loại giao dịch mua. |
productId |
Mã sản phẩm hoặc mã ưu đãi được liên kết với mục hàng này. |
quantity |
Số lượng của mặt hàng. |
unitMeasure |
Đơ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 |
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 |
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[] |
Tiện ích bổ sung hoặc mục phụ bổ sung. |
extension |
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 |
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 ( |
Các trường | |
---|---|
measure |
Giá trị: Ví dụ 1.2. |
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 ( |
Các trường | |
---|---|
id |
Đối với các lựa chọn là mặt hàng, mã mặt hàng duy nhất. |
name |
Tên lựa chọn. |
prices[] |
Tổng giá cho lựa chọn. |
note |
Ghi chú liên quan đến lựa chọn này. |
quantity |
Đối với các lựa chọn là mặt hàng, hãy chọn số lượng. |
productId |
Mã sản phẩm hoặc mã ưu đãi liên kết với lựa chọn này. |
subOptions[] |
Để 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 |
Mã sản phẩm hoặc mã ưu đãi được liên kết với mục hàng này. |
gtin |
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 |
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 |
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 |
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 |
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 ( |
Các trường | |
---|---|
status |
Bắt buộc: Trạng thái đặt trước. |
userVisibleStatusLabel |
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 |
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 |
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 |
phạm vi thời gian mà người dùng có thể chấp nhận. |
confirmationCode |
Mã xác nhận cho yêu cầu đặt chỗ này. |
partySize |
Số người. |
staffFacilitators[] |
Nhân viên hỗ trợ sẽ phục vụ yêu cầu đặt chỗ. Ví dụ: Thợ làm tóc. |
location |
Địa điểm của dịch vụ/sự kiện. |
extension |
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 |
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 ( |
Các trường | |
---|---|
name |
Tên của người hỗ trợ nhân viên. Ví dụ: "John Smith" |
image |
Hình ảnh của người biểu diễn. |