- Tài nguyên: Sản phẩm
- Thuộc tính
- Trả góp
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Phí vận chuyển
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Thuế
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Chứng nhận
- ProductStructuredTitle
- ProductStructuredDescription
- ProductStatus
- DestinationStatus
- ItemLevelIssue
- Tính nghiêm trọng
- Phương thức
Tài nguyên: Sản phẩm
Sản phẩm đã xử lý được tạo từ nhiều [dữ liệu đầu vào của sản phẩm][[google.shopping.content.bundles.Products.ProductInput] sau khi áp dụng các quy tắc và nguồn dữ liệu bổ sung. Sản phẩm đã xử lý này khớp với sản phẩm xuất hiện trong tài khoản Merchant Center của bạn và trong quảng cáo Mua sắm cũng như các nền tảng khác của Google. Mỗi sản phẩm được tạo từ đúng một dữ liệu đầu vào cho sản phẩm của nguồn dữ liệu chính và nhiều dữ liệu đầu vào của nguồn dữ liệu bổ sung. Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất sản phẩm đã xử lý mà bạn cập nhật.
Tất cả các trường trong sản phẩm đã xử lý và thông báo phụ của sản phẩm đó đều khớp với tên của thuộc tính tương ứng trong Quy cách dữ liệu sản phẩm, trừ một số trường hợp ngoại lệ.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "channel": enum ( |
Trường | |
---|---|
name |
Tên sản phẩm. Định dạng |
channel |
Chỉ có đầu ra. Kênh của sản phẩm. |
offerId |
Chỉ có đầu ra. Giá trị nhận dạng duy nhất của sản phẩm. Điều này tương tự với sản phẩm đầu vào và sản phẩm đã xử lý. Khoảng trắng ở đầu và ở cuối bị xoá đi và nhiều khoảng trắng được thay bằng một khoảng trắng duy nhất khi gửi. Tham khảo quy cách dữ liệu sản phẩm để biết chi tiết. |
contentLanguage |
Chỉ có đầu ra. Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 cho sản phẩm. |
feedLabel |
Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho sản phẩm. |
dataSource |
Chỉ có đầu ra. Nguồn dữ liệu chính của sản phẩm. |
attributes |
Chỉ có đầu ra. Danh sách các thuộc tính sản phẩm. |
customAttributes[] |
Chỉ có đầu ra. Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể sử dụng thuộc tính này để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung (ví dụ: |
productStatus |
Chỉ có đầu ra. Trạng thái của một sản phẩm, vấn đề về xác thực dữ liệu, tức là thông tin về một sản phẩm được tính toán không đồng bộ. |
versionNumber |
Chỉ có đầu ra. Đại diện cho phiên bản hiện có (độ mới) của sản phẩm, có thể được dùng để duy trì thứ tự phù hợp khi nhiều nội dung cập nhật được thực hiện cùng một lúc. Nếu bạn đặt số này, việc chèn sẽ không được thực hiện khi số phiên bản thấp hơn số phiên bản hiện tại của sản phẩm hiện có. Bạn có thể chèn lại (ví dụ: làm mới sản phẩm sau 30 ngày) bằng Chỉ hỗ trợ để chèn vào nguồn dữ liệu chính. Nếu thao tác này bị ngăn chặn, thì ngoại lệ bị huỷ sẽ được gửi. |
Thuộc tính
Thuộc tính.
Biểu diễn dưới dạng JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "price": { object ( |
Trường | |
---|---|
additionalImageLinks[] |
URL hình ảnh bổ sung của mặt hàng. |
expirationDate |
Ngày mà mục hết hạn, như chỉ định khi chèn, ở định dạng ISO 8601. Ngày hết hạn thực tế được hiển thị ở |
disclosureDate |
Ngày mà sản phẩm/dịch vụ xuất hiện trong kết quả tìm kiếm trên các nền tảng của Google trên YouTube, ở định dạng ISO 8601. Xem [Ngày công bố]( https://support.google.com/merchants/answer/13034208) để biết thêm thông tin. |
availabilityDate |
Ngày mà sản phẩm được đặt hàng trước có hàng để giao, ở định dạng ISO 8601. |
price |
Giá của mặt hàng. |
installment |
Số tiền và số tiền trả góp cho một mặt hàng. |
subscriptionCost |
Số kỳ (tháng hoặc năm) và số tiền thanh toán cho mỗi kỳ cho một mặt hàng có hợp đồng thuê bao liên quan. |
loyaltyPoints |
Điểm khách hàng thân thiết mà người dùng nhận được sau khi mua mặt hàng. Chỉ ở Nhật Bản. |
loyaltyPrograms[] |
Danh sách thông tin về chương trình khách hàng thân thiết được dùng để hiển thị các lợi ích của chương trình khách hàng thân thiết (ví dụ: giá tốt hơn, điểm, v.v.) cho người dùng mặt hàng này. |
productTypes[] |
Danh mục mặt hàng (được định dạng như trong quy cách dữ liệu sản phẩm). |
salePrice |
Giá ưu đãi trong quảng cáo của mặt hàng. |
salePriceEffectiveDate |
Phạm vi ngày giảm giá mặt hàng (xem quy cách dữ liệu sản phẩm). |
productHeight |
Chiều cao của sản phẩm tính theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm). |
productLength |
Chiều dài của sản phẩm tính theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm). |
productWidth |
Chiều rộng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 3000 (bao gồm). |
productWeight |
Trọng lượng của sản phẩm theo đơn vị được cung cấp. Giá trị phải nằm trong khoảng từ 0 (không bao gồm) đến 2000 (bao gồm). |
shipping[] |
Quy tắc vận chuyển. |
freeShippingThreshold[] |
Bạn cần đáp ứng các điều kiện để sản phẩm được vận chuyển miễn phí. |
shippingWeight |
Trọng lượng của mặt hàng để vận chuyển. |
shippingLength |
Chiều dài của mặt hàng để vận chuyển. |
shippingWidth |
Chiều rộng của mặt hàng để vận chuyển. |
shippingHeight |
Chiều cao của mặt hàng để vận chuyển. |
sizeTypes[] |
Đoạn cắt của mặt hàng. Thuộc tính này có thể dùng để đại diện cho các loại kích thước kết hợp của các mặt hàng may mặc. Bạn có thể cung cấp tối đa 2 loại kích thước (xem [https://support.google.com/merchants/answer/6324497](loại kích thước)). |
taxes[] |
Thông tin thuế. |
unitPricingMeasure |
Số lượng đo lường và kích thước của một mặt hàng. |
unitPricingBaseMeasure |
Lựa chọn ưu tiên của mẫu số của đơn giá. |
adsLabels[] |
Tương tự như adsGrouping, nhưng chỉ hoạt động trên CPC. |
costOfGoodsSold |
Giá vốn hàng bán. Dùng để báo cáo lợi nhuận gộp. |
productDetails[] |
Thông số kỹ thuật hoặc chi tiết bổ sung về sản phẩm. |
productHighlights[] |
Gạch đầu dòng mô tả những điểm nổi bật phù hợp nhất của sản phẩm. |
displayAdsSimilarIds[] |
Các đề xuất do nhà quảng cáo chỉ định. |
promotionIds[] |
Mã nhận dạng duy nhất của chương trình khuyến mãi. |
includedDestinations[] |
Danh sách vị trí xuất hiện cần đưa vào mục tiêu này (tương ứng với hộp kiểm đã đánh dấu trong Merchant Center). Đích đến mặc định luôn được đưa vào trừ phi được cung cấp trong |
excludedDestinations[] |
Danh sách các vị trí xuất hiện cần loại trừ khỏi mục tiêu này (tương ứng với các hộp kiểm chưa đánh dấu trong Merchant Center). |
shoppingAdsExcludedCountries[] |
Danh sách mã quốc gia (ISO 3166-1 alpha-2) để loại trừ mặt hàng khỏi đích đến của Quảng cáo mua sắm. Các quốc gia trong danh sách này sẽ bị xoá khỏi những quốc gia đã thiết lập trong chế độ cài đặt nguồn dữ liệu. |
lifestyleImageLinks[] |
URL bổ sung của hình ảnh phong cách sống của mặt hàng, dùng để xác định rõ ràng những hình ảnh thể hiện mặt hàng của bạn trong bối cảnh thực tế. Hãy xem bài viết này trên Trung tâm trợ giúp để biết thêm thông tin. |
cloudExportAdditionalProperties[] |
Các trường bổ sung để xuất sang chương trình Cloud Retail. |
certifications[] |
Chứng nhận sản phẩm, ví dụ như dán nhãn hiệu suất năng lượng của những sản phẩm được ghi lại trong cơ sở dữ liệu EPREL của EU. Hãy xem bài viết này trên Trung tâm trợ giúp để biết thêm thông tin. |
autoPricingMinPrice |
Biện pháp bảo vệ trong "Chương trình chiết khấu tự động" (https://support.google.com/merchants/answer/10295759) và "Khuyến mãi động" (https://support.google.com/merchants/answer/13949249) nhằm đảm bảo rằng chiết khấu đối với người bán không giảm xuống thấp hơn giá trị này, do đó duy trì giá trị và khả năng sinh lời của ưu đãi. |
identifierExists |
Hãy đặt giá trị này thành false khi mặt hàng không có mã nhận dạng sản phẩm duy nhất phù hợp với danh mục, chẳng hạn như GTIN (Mã số sản phẩm thương mại toàn cầu), MPN (Mã số linh kiện của nhà sản xuất) và thương hiệu. Giá trị mặc định là true (đúng) nếu không được cung cấp. |
isBundle |
Liệu mặt hàng có phải là gói do người bán xác định hay không. Gói là một nhóm tùy chỉnh gồm các sản phẩm khác nhau mà người bán bán theo một mức giá duy nhất. |
title |
Tiêu đề của mặt hàng. |
description |
Nội dung mô tả mặt hàng. |
link |
URL liên kết trực tiếp đến trang bán mặt hàng trên cửa hàng trực tuyến của bạn. |
mobileLink |
URL cho phiên bản được tối ưu hóa cho thiết bị di động của trang đích của mặt hàng. |
canonicalLink |
URL cho phiên bản chuẩn của trang đích của mặt hàng. |
imageLink |
URL hình ảnh của mặt hàng. |
adult |
Đặt thành true nếu mặt hàng nhắm đến người lớn. |
ageGroup |
Nhắm đến nhóm tuổi của mặt hàng. |
availability |
Trạng thái tình trạng còn hàng của mặt hàng. |
brand |
Thương hiệu của mặt hàng. |
color |
Màu của mặt hàng. |
condition |
Tình trạng hoặc trạng thái của mặt hàng. |
gender |
Giới tính mục tiêu của mặt hàng. |
googleProductCategory |
Danh mục mặt hàng của Google (xem bài viết Hệ thống phân loại sản phẩm của Google). Khi truy vấn sản phẩm, trường này sẽ chứa giá trị do người dùng cung cấp. Hiện tại, không có cách nào để lấy lại danh mục sản phẩm của Google được tự động chỉ định thông qua API. |
gtin |
Mã số sản phẩm thương mại toàn cầu (GTIN) của mặt hàng. |
itemGroupId |
Mã nhận dạng dùng chung cho tất cả biến thể của cùng một sản phẩm. |
material |
Chất liệu tạo ra mặt hàng. |
mpn |
Mã số linh kiện của nhà sản xuất (MPN) của mặt hàng. |
pattern |
Hoa văn của mặt hàng (ví dụ: chấm bi). |
sellOnGoogleQuantity |
Số lượng sản phẩm có sẵn để bán trên Google. Chỉ được hỗ trợ cho các sản phẩm bán trực tuyến. |
maxHandlingTime |
Thời gian xử lý sản phẩm tối đa (tính theo ngày làm việc). |
minHandlingTime |
Thời gian xử lý sản phẩm tối thiểu (tính theo ngày làm việc). |
shippingLabel |
Nhãn vận chuyển của sản phẩm, dùng để nhóm sản phẩm trong các quy tắc vận chuyển cấp tài khoản. |
transitTimeLabel |
Nhãn thời gian vận chuyển của sản phẩm, dùng để nhóm sản phẩm trong bảng thời gian vận chuyển cấp tài khoản. |
size |
Kích thước của mục. Chỉ cho phép một giá trị. Đối với các biến thể có kích thước khác nhau, hãy chèn một sản phẩm riêng cho từng kích thước có cùng giá trị |
sizeSystem |
Hệ thống mà trong đó kích thước được chỉ định. Nên dùng cho các mặt hàng may mặc. |
taxCategory |
Danh mục thuế của sản phẩm, dùng để định cấu hình mối liên hệ chi tiết về thuế trong chế độ cài đặt thuế ở cấp tài khoản. |
energyEfficiencyClass |
Cấp hiệu suất năng lượng theo chỉ thị 2010/30/EU của Liên minh Châu Âu. |
minEnergyEfficiencyClass |
Cấp hiệu suất năng lượng theo chỉ thị 2010/30/EU của Liên minh Châu Âu. |
maxEnergyEfficiencyClass |
Cấp hiệu suất năng lượng theo chỉ thị 2010/30/EU của Liên minh Châu Âu. |
multipack |
Số lượng sản phẩm giống nhau trong một lô sản phẩm do người bán xác định. |
adsGrouping |
Dùng để nhóm các mục một cách tuỳ ý. Chỉ dành cho CPA%, không khuyến khích nếu không được sử dụng. |
adsRedirect |
Cho phép nhà quảng cáo thay thế URL của mặt hàng khi sản phẩm xuất hiện trong ngữ cảnh của Quảng cáo sản phẩm. |
displayAdsId |
Giá trị nhận dạng của một mặt hàng trong chiến dịch tái tiếp thị linh động. |
displayAdsTitle |
Tiêu đề của mặt hàng cho chiến dịch tái tiếp thị linh động. |
displayAdsLink |
URL thẳng đến trang đích của mặt hàng cho các chiến dịch tái tiếp thị linh động. |
displayAdsValue |
Lợi nhuận của mặt hàng cho các chiến dịch tái tiếp thị linh động. |
pickupMethod |
Lựa chọn đến lấy hàng cho mặt hàng đó. |
pickupSla |
Tiến trình lấy tại cửa hàng. |
linkTemplate |
Mẫu đường liên kết cho trang chủ cửa hàng địa phương do người bán lưu trữ. |
mobileLinkTemplate |
Mẫu đường liên kết cho trang chủ cửa hàng địa phương do người bán lưu trữ được tối ưu hoá cho thiết bị di động. |
customLabel0 |
Nhãn tuỳ chỉnh 0 để nhóm các mặt hàng tuỳ chỉnh trong một chiến dịch Mua sắm. |
customLabel1 |
Nhãn tuỳ chỉnh 1 để nhóm các mặt hàng tuỳ chỉnh trong một chiến dịch Mua sắm. |
customLabel2 |
Nhãn tuỳ chỉnh 2 để nhóm các mặt hàng tuỳ chỉnh trong một chiến dịch Mua sắm. |
customLabel3 |
Nhãn tuỳ chỉnh 3 để nhóm các mặt hàng tuỳ chỉnh trong một chiến dịch Mua sắm. |
customLabel4 |
Nhãn tuỳ chỉnh 4 để nhóm các mặt hàng tuỳ chỉnh trong một chiến dịch Mua sắm. |
externalSellerId |
Bắt buộc đối với tài khoản nhiều người bán. Sử dụng thuộc tính này nếu bạn là một trang web thương mại và bạn tải sản phẩm cho nhiều người bán lên tài khoản nhiều người bán. |
pause |
Việc xuất bản mục này sẽ bị tạm dừng. |
virtualModelLink |
URL hình ảnh 3D của mặt hàng. Hãy xem bài viết này trên Trung tâm trợ giúp để biết thêm thông tin. |
structuredTitle |
Tiêu đề có cấu trúc, dành cho tiêu đề do thuật toán (AI) tạo. |
structuredDescription |
Nội dung mô tả có cấu trúc, dành cho nội dung mô tả do thuật toán (AI) tạo. |
Trả góp
Thông báo đại diện cho hình thức trả góp.
Biểu diễn dưới dạng JSON |
---|
{ "months": string, "amount": { object ( |
Trường | |
---|---|
months |
Số lần trả góp mà người mua phải trả. |
amount |
Số tiền mà người mua phải trả mỗi tháng. |
downpayment |
Số tiền trả trước toàn bộ mà người mua phải trả. |
creditType |
Hình thức thanh toán trả góp. Các giá trị được hỗ trợ là: * " |
SubscriptionCost
Chi phí thuê bao của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "period": enum ( |
Trường | |
---|---|
period |
Loại thời hạn thuê bao. Các giá trị được hỗ trợ là: * " |
periodLength |
Số kỳ hạn của gói thuê bao mà người mua phải trả. |
amount |
Số tiền mà người mua phải trả cho mỗi kỳ hạn của gói thuê bao. |
SubscriptionPeriod
Thời hạn thuê bao của sản phẩm.
Enum | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Cho biết thời hạn của gói thuê bao chưa được chỉ định. |
MONTH |
Cho biết thời hạn của gói thuê bao là tháng. |
YEAR |
Cho biết thời hạn của gói thuê bao là một năm. |
LoyaltyPoints
Một thông điệp tượng trưng cho điểm khách hàng thân thiết.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Trường | |
---|---|
name |
Tên chương trình điểm khách hàng thân thiết. Bạn nên sử dụng tối đa 12 ký tự có độ rộng đầy đủ hoặc 24 ký tự La Mã. |
pointsValue |
Điểm khách hàng thân thiết của nhà bán lẻ theo giá trị tuyệt đối. |
ratio |
Tỷ lệ của một điểm khi chuyển đổi sang đơn vị tiền tệ. Google giả định đơn vị tiền tệ dựa trên chế độ cài đặt của Merchant Center. Nếu bạn không để tỷ lệ này, giá trị mặc định sẽ là 1.0. |
LoyaltyProgram
Một thông báo đại diện cho chương trình khách hàng thân thiết.
Biểu diễn dưới dạng JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
Trường | |
---|---|
programLabel |
Nhãn của chương trình khách hàng thân thiết. Đây là nhãn nội bộ xác định duy nhất mối quan hệ giữa pháp nhân người bán và pháp nhân chương trình khách hàng thân thiết. Bạn phải cung cấp nhãn để hệ thống có thể liên kết các thành phần bên dưới (ví dụ như giá và điểm) với người bán. Bạn phải liên kết chương trình tương ứng với tài khoản người bán. |
tierLabel |
Nhãn của bậc trong chương trình khách hàng thân thiết. Phải khớp với một trong các nhãn trong chương trình. |
price |
Giá dành cho thành viên của cấp cụ thể, tức là giá chiết khấu tức thì. Phải nhỏ hơn hoặc bằng giá thông thường. |
cashbackForFutureUse |
Khoản tiền hoàn lại có thể được sử dụng cho các giao dịch mua trong tương lai. |
loyaltyPoints |
Số điểm khách hàng thân thiết nhận được khi mua hàng. |
memberPriceEffectiveDate |
Phạm vi ngày mà mặt hàng đủ điều kiện áp dụng giá dành cho thành viên. Nếu không được chỉ định, giá dành cho thành viên sẽ luôn áp dụng. Phạm vi ngày được thể hiện bằng một cặp ngày ISO 8601 được phân tách bằng dấu cách, dấu phẩy hoặc dấu gạch chéo. |
ProductDimension
Kích thước của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "unit": string } |
Trường | |
---|---|
value |
Bắt buộc. Giá trị phương diện được biểu thị dưới dạng số. Giá trị này có thể có độ chính xác tối đa là bốn chữ số thập phân. |
unit |
Bắt buộc. Các đơn vị thứ nguyên. Các giá trị được chấp nhận là: * " |
ProductWeight
Trọng lượng của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "unit": string } |
Trường | |
---|---|
value |
Bắt buộc. Trọng số được biểu thị dưới dạng số. Trọng số có thể có độ chính xác tối đa là 4 chữ số thập phân. |
unit |
Bắt buộc. Đơn vị trọng lượng. Các giá trị được chấp nhận là: * " |
Giao hàng
Thông tin vận chuyển sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{
"price": {
object ( |
Trường | |
---|---|
price |
Giá vận chuyển cố định, được thể hiện bằng một số. |
country |
Mã lãnh thổ CLDR của quốc gia mà mặt hàng sẽ được vận chuyển đến. |
region |
Khu vực địa lý áp dụng mức phí vận chuyển. Hãy xem mục khu vực để biết thêm thông tin. |
service |
Nội dung mô tả ở dạng tự do về hạng dịch vụ hoặc tốc độ giao hàng. |
locationId |
Mã dạng số của một vị trí được áp dụng mức phí vận chuyển này, xác định trong API AdWords. |
locationGroupName |
Vị trí có áp dụng phí vận chuyển, được thể hiện bằng tên nhóm địa điểm. |
postalCode |
Phạm vi mã bưu chính áp dụng mức phí vận chuyển, được biểu thị bằng một mã bưu chính, một tiền tố mã bưu chính theo sau là ký tự đại diện *, là phạm vi giữa hai mã bưu chính hoặc hai tiền tố mã bưu chính có độ dài bằng nhau. |
minHandlingTime |
Thời gian xử lý tối thiểu (bao gồm cả ngày này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được vận chuyển trong cùng ngày nhận được nếu đơn đặt hàng đó diễn ra trước hạn chót nhận đơn đặt hàng. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] khác nhưng không bắt buộc nếu có thuộc tính [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]. |
maxHandlingTime |
Thời gian xử lý tối đa (bao gồm cả ngày này) tính từ khi nhận được đơn đặt hàng đến khi giao hàng (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được vận chuyển trong cùng ngày nhận được nếu đơn đặt hàng đó diễn ra trước hạn chót nhận đơn đặt hàng. Cả [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] và [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] đều khác nếu cung cấp tốc độ vận chuyển. Bạn không bắt buộc phải sử dụng [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] nếu có thuộc tính [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]. |
minTransitTime |
Thời gian vận chuyển tối thiểu (bao gồm cả ngày này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được giao trong cùng ngày vận chuyển. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] chỉ có thể xuất hiện cùng với [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; nhưng không bắt buộc nếu có [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. |
maxTransitTime |
Thời gian vận chuyển tối đa (bao gồm cả ngày này) tính từ khi đơn đặt hàng được vận chuyển đến khi đơn đặt hàng được giao (tính theo ngày làm việc). 0 có nghĩa là đơn đặt hàng được giao trong cùng ngày vận chuyển. Cả [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] và [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] đều khác nếu cung cấp tốc độ vận chuyển. Bạn không bắt buộc phải sử dụng [mintransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] nếu có thuộc tính [maxtransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. |
FreeShippingThreshold
Bạn cần đáp ứng các điều kiện để sản phẩm được vận chuyển miễn phí.
Biểu diễn dưới dạng JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
Trường | |
---|---|
country |
Mã lãnh thổ CLDR của quốc gia mà mặt hàng sẽ được vận chuyển đến. |
priceThreshold |
Giá sản phẩm tối thiểu để trở thành phí vận chuyển miễn phí. Được biểu diễn dưới dạng số. |
ShippingWeight
Trọng lượng vận chuyển của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "unit": string } |
Trường | |
---|---|
value |
Trọng lượng của sản phẩm dùng để tính phí vận chuyển của mặt hàng. |
unit |
Đơn vị của giá trị. |
ShippingDimension
Kích thước vận chuyển của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "unit": string } |
Trường | |
---|---|
value |
Kích thước của sản phẩm dùng để tính phí vận chuyển của mặt hàng. |
unit |
Đơn vị của giá trị. |
Thuế
Thuế của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
Trường | |
---|---|
rate |
Tỷ lệ phần trăm thuế suất áp dụng cho giá mặt hàng. |
country |
Quốc gia nơi mặt hàng bị đánh thuế, được chỉ định theo mã lãnh thổ CLDR. |
region |
Khu vực địa lý áp dụng thuế suất. |
taxShip |
Đặt thành true nếu tính thuế đối với phí vận chuyển. |
locationId |
Mã dạng số của một vị trí được áp dụng thuế suất này theo xác định trong API AdWords. |
postalCode |
Phạm vi mã bưu chính mà thuế suất áp dụng, được thể hiện bằng một mã ZIP, một tiền tố mã ZIP sử dụng ký tự đại diện *, là phạm vi giữa 2 mã ZIP hoặc 2 tiền tố mã ZIP có độ dài bằng nhau. Ví dụ: 94114, 94*, 94002-95460, 94*-95*. |
UnitPricingMeasure
Đơn vị đo lường của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": number, "unit": string } |
Trường | |
---|---|
value |
Số đo của một mặt hàng. |
unit |
Đơn vị đo lường. |
UnitPricingBaseMeasure
UnitPricingBaseMeasure của sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "value": string, "unit": string } |
Trường | |
---|---|
value |
Mẫu số của đơn giá. |
unit |
Đơn vị của mẫu số. |
ProductDetail
Chi tiết sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Trường | |
---|---|
sectionName |
Tiêu đề mục dùng để nhóm một bộ chi tiết sản phẩm. |
attributeName |
Tên chi tiết sản phẩm. |
attributeValue |
Giá trị của chi tiết sản phẩm. |
CloudExportAdditionalProperties
Thuộc tính sản phẩm cho Cloud Retail API. Ví dụ: thuộc tính cho một sản phẩm TV có thể là "Screen-Resolution" (Độ phân giải màn hình) hoặc "Kích thước màn hình".
Biểu diễn dưới dạng JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
Trường | |
---|---|
textValue[] |
Giá trị văn bản của thuộc tính đã cho. Ví dụ: "8K(UHD)" có thể là giá trị văn bản cho sản phẩm TV. Giá trị này lặp lại tối đa là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán. Kích thước chuỗi tối đa là 256 ký tự. |
intValue[] |
Giá trị số nguyên của một thuộc tính đã cho. Ví dụ: 1080 cho Độ phân giải màn hình của một sản phẩm TV. Giá trị này lặp lại tối đa là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán. |
floatValue[] |
Giá trị số thực của thuộc tính đã cho. Ví dụ đối với sản phẩm TV 1.2345. Giá trị này lặp lại tối đa là 400. Các giá trị được lưu trữ theo thứ tự tuỳ ý nhưng nhất quán. |
propertyName |
Tên của thuộc tính đã cho. Ví dụ: "Độ phân giải màn hình" cho một sản phẩm TV. Kích thước chuỗi tối đa là 256 ký tự. |
boolValue |
Giá trị boolean của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV, "Đúng" hoặc "False" nếu màn hình UHD. |
minValue |
Giá trị số thực tối thiểu của thuộc tính đã cho. Ví dụ đối với sản phẩm TV 1.00. |
maxValue |
Giá trị số thực lớn nhất của thuộc tính đã cho. Ví dụ: đối với sản phẩm TV 100.00. |
unitCode |
Đơn vị của thuộc tính đã cho. Ví dụ: "Pixel" cho một sản phẩm TV. Kích thước chuỗi tối đa là 256B. |
Giấy chứng nhận
Chứng nhận sản phẩm, ban đầu được giới thiệu nhằm tuân thủ việc dán nhãn hiệu suất năng lượng của EU thông qua cơ sở dữ liệu EPREL của EU.
Biểu diễn dưới dạng JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
Trường | |
---|---|
certificationAuthority |
Tổ chức phát hành chứng nhận, ví dụ: "European_Commission". Độ dài tối đa là 2000 ký tự. |
certificationName |
Tên của giấy chứng nhận, chẳng hạn như "EPREL". Độ dài tối đa là 2000 ký tự. |
certificationCode |
Mã chứng nhận. Độ dài tối đa là 2000 ký tự. |
certificationValue |
Giá trị chứng nhận (còn gọi là lớp, cấp hoặc điểm), ví dụ như "A+", "C", "vàng". Độ dài tối đa là 2000 ký tự. |
ProductStructuredTitle
Tiêu đề có cấu trúc dành cho tiêu đề do thuật toán (AI) tạo.
Biểu diễn dưới dạng JSON |
---|
{ "digitalSourceType": string, "content": string } |
Trường | |
---|---|
digitalSourceType |
Loại nguồn kỹ thuật số, ví dụ: "trained_algorithmic_media". Đang theo dõi IPTC. Độ dài tối đa là 40 ký tự. |
content |
Văn bản tiêu đề Độ dài tối đa là 150 ký tự |
ProductStructuredDescription
Nội dung mô tả có cấu trúc, dành cho nội dung mô tả do thuật toán (AI) tạo.
Biểu diễn dưới dạng JSON |
---|
{ "digitalSourceType": string, "content": string } |
Trường | |
---|---|
digitalSourceType |
Loại nguồn kỹ thuật số, ví dụ: "trained_algorithmic_media". Đang theo dõi IPTC. Độ dài tối đa là 40 ký tự. |
content |
Văn bản mô tả Độ dài tối đa là 5.000 ký tự |
ProductStatus
Trạng thái của một sản phẩm, vấn đề về xác thực dữ liệu, tức là thông tin về một sản phẩm được tính toán không đồng bộ.
Biểu diễn dưới dạng JSON |
---|
{ "destinationStatuses": [ { object ( |
Trường | |
---|---|
destinationStatuses[] |
Vị trí xuất hiện dự kiến cho sản phẩm. |
itemLevelIssues[] |
Danh sách tất cả các vấn đề liên quan đến sản phẩm. |
creationDate |
Ngày tạo mục, ở định dạng ISO 8601. |
lastUpdateDate |
Ngày cập nhật mục gần đây nhất, ở định dạng ISO 8601. |
googleExpirationDate |
Ngày hết hạn của mặt hàng, ở định dạng ISO 8601. |
DestinationStatus
Trạng thái đích đến của trạng thái sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{
"reportingContext": enum ( |
Trường | |
---|---|
reportingContext |
Tên của ngữ cảnh báo cáo. |
approvedCountries[] |
Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi mặt hàng được phê duyệt. |
pendingCountries[] |
Danh sách mã quốc gia (ISO 3166-1 alpha-2) có mặt hàng đang chờ phê duyệt. |
disapprovedCountries[] |
Danh sách mã quốc gia (ISO 3166-1 alpha-2) mà mặt hàng bị từ chối. |
ItemLevelIssue
Item LevelIssue của trạng thái sản phẩm.
Biểu diễn dưới dạng JSON |
---|
{ "code": string, "severity": enum ( |
Trường | |
---|---|
code |
Mã lỗi của vấn đề. |
severity |
Vấn đề này ảnh hưởng như thế nào đến việc phân phát của mặt hàng. |
resolution |
Liệu người bán có thể giải quyết vấn đề này hay không. |
attribute |
Tên của thuộc tính, nếu vấn đề là do một thuộc tính duy nhất gây ra. |
reportingContext |
Ngữ cảnh báo cáo áp dụng vấn đề. |
description |
Nội dung mô tả ngắn về vấn đề bằng tiếng Anh. |
detail |
Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh. |
documentation |
URL của một trang web giúp giải quyết vấn đề này. |
applicableCountries[] |
Danh sách mã quốc gia (ISO 3166-1 alpha-2) có vấn đề xảy ra với mặt hàng. |
Mức độ nghiêm trọng
Ảnh hưởng của vấn đề đến hoạt động phân phát sản phẩm.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Chưa chỉ định. |
NOT_IMPACTED |
Vấn đề này là một cảnh báo chứ không ảnh hưởng trực tiếp đến sản phẩm. |
DEMOTED |
Sản phẩm bị giảm hạng và rất có thể có hiệu suất hạn chế trong kết quả tìm kiếm |
DISAPPROVED |
Vấn đề sẽ từ chối sản phẩm. |
Phương thức |
|
---|---|
|
Truy xuất sản phẩm đã xử lý từ tài khoản Merchant Center. |
|
Liệt kê các sản phẩm đã xử lý trong tài khoản Merchant Center của bạn. |