REST Resource: accounts.products

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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Trường
name

string

Tên sản phẩm. Định dạng "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Chỉ có đầu ra. Kênh của sản phẩm.
offerId

string

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

string

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

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho sản phẩm.
dataSource

string

Chỉ có đầu ra. Nguồn dữ liệu chính của sản phẩm.
attributes

object (Attributes)

Chỉ có đầu ra. Danh sách các thuộc tính sản phẩm.
customAttributes[]

object (CustomAttribute)

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ể gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung chung (ví dụ: { "name": "size type", "value": "regular" }). Cách này rất hữu ích khi gửi các thuộc tính mà API không nêu rõ, chẳng hạn như các thuộc tính bổ sung dùng cho chương trình Mua trên Google.
productStatus

object (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

string (int64 format)

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 versionNumber hiện tại.

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 (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Trường
expirationDate

string (Timestamp format)

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ị trong productstatuses là googleExpirationDate và có thể sớm hơn nếu expirationDate là quá xa trong tương lai.
disclosureDate

string (Timestamp format)

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

string (Timestamp format)

Ngày mà sản phẩm được đặt hàng trước có hàng để giao, ở định dạng ISO 8601.
price

object (Price)

Giá của mặt hàng.
installment

object (Installment)

Số tiền và số tiền trả góp cho một mặt hàng.
subscriptionCost

object (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

object (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[]

object (LoyaltyProgram)

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[]

string

Danh mục mặt hàng (được định dạng như trong quy cách dữ liệu sản phẩm).
salePrice

object (Price)

Giá ưu đãi trong quảng cáo của mặt hàng.
salePriceEffectiveDate

object (Interval)

Phạm vi ngày giảm giá mặt hàng (xem quy cách dữ liệu sản phẩm).
productHeight

object (ProductDimension)

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

object (ProductDimension)

Chiều dài của sản phẩm tính bằng các đơ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

object (ProductDimension)

Chiều rộng của sản phẩm theo các đơ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

object (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[]

object (Shipping)

Quy tắc vận chuyển.
freeShippingThreshold[]

object (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

object (ShippingWeight)

Trọng lượng của mặt hàng để vận chuyển.
shippingLength

object (ShippingDimension)

Chiều dài của mặt hàng để vận chuyển.
shippingWidth

object (ShippingDimension)

Chiều rộng của mặt hàng để vận chuyển.
shippingHeight

object (ShippingDimension)

Chiều cao của mặt hàng để vận chuyển.
sizeTypes[]

string

Đ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[]

object (Tax)

Thông tin thuế.
unitPricingMeasure

object (UnitPricingMeasure)

Số lượng đo lường và kích thước của một mặt hàng.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

Lựa chọn ưu tiên của mẫu số của đơn giá.
adsLabels[]

string

Tương tự như adsGrouping, nhưng chỉ hoạt động trên CPC.
costOfGoodsSold

object (Price)

Giá vốn hàng bán. Dùng để báo cáo lợi nhuận gộp.
productDetails[]

object (ProductDetail)

Thông số kỹ thuật hoặc chi tiết bổ sung về sản phẩm.
productHighlights[]

string

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[]

string

Các đề xuất do nhà quảng cáo chỉ định.
promotionIds[]

string

Mã nhận dạng duy nhất của chương trình khuyến mãi.
includedDestinations[]

string

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.
excludedDestinations[]

string

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[]

string

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.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Các trường bổ sung để xuất sang chương trình Cloud Retail.
certifications[]

object (Certification)

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

object (Price)

Một biện pháp bảo vệ trong các dự án "Chiết khấu tự động" (https://support.google.com/merchants/answer/10295759) và "Chương trình khuyến mãi linh động" (https://support.google.com/merchants/answer/13949249) giúp đảm bảo mức chiết khấu cho mặt hàng của người bán không thấp hơn giá trị này, nhờ đó duy trì giá trị và khả năng sinh lời của ưu đãi.
identifierExists

boolean

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

boolean

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

string

Tiêu đề của mặt hàng.
description

string

Nội dung mô tả mặt hàng.
adult

boolean

Đặt thành true nếu mặt hàng nhắm đến người lớn.
ageGroup

string

Nhắm đến nhóm tuổi của mặt hàng.
availability

string

Trạng thái tình trạng còn hàng của mặt hàng.
brand

string

Thương hiệu của mặt hàng.
color

string

Màu của mặt hàng.
condition

string

Tình trạng hoặc trạng thái của mặt hàng.
gender

string

Giới tính mục tiêu của mặt hàng.
googleProductCategory

string

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

string

Mã số sản phẩm thương mại toàn cầu (GTIN) của mặt hàng.
itemGroupId

string

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

string

Chất liệu tạo ra mặt hàng.
mpn

string

Mã số linh kiện của nhà sản xuất (MPN) của mặt hàng.
pattern

string

Hoa văn của mặt hàng (ví dụ: chấm bi).
sellOnGoogleQuantity

string (int64 format)

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

string (int64 format)

Thời gian xử lý sản phẩm tối đa (tính theo ngày làm việc).
minHandlingTime

string (int64 format)

Thời gian xử lý sản phẩm tối thiểu (tính theo ngày làm việc).
shippingLabel

string

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

string

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

string

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ị itemGroupId (xem [https://support.google.com/merchants/answer/6324492](định nghĩa kích thước)).
sizeSystem

string

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

string

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

string

Tiêu đề của mặt hàng cho chiến dịch tái tiếp thị linh động.
displayAdsValue

number

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

string

Lựa chọn đến lấy hàng cho mặt hàng đó.
pickupSla

string

Tiến trình lấy tại cửa hàng.
customLabel0

string

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

string

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

string

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

string

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

string

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

string

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

string

Việc xuất bản mục này sẽ bị tạm dừng.
structuredTitle

object (ProductStructuredTitle)

Tiêu đề có cấu trúc, dành cho tiêu đề do thuật toán (AI) tạo.
structuredDescription

object (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.

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 (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Trường
months

string (int64 format)

Số lần trả góp mà người mua phải trả.
amount

object (Price)

Số tiền mà người mua phải trả mỗi tháng.
downpayment

object (Price)

Số tiền trả trước toàn bộ mà người mua phải trả.
creditType

string

Hình thức thanh toán trả góp. Các giá trị được hỗ trợ là: * "finance" * "lease"

SubscriptionCost

Chi phí thuê bao của sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Trường
period

enum (SubscriptionPeriod)

Loại thời hạn thuê bao. Các giá trị được hỗ trợ là: * "month" * "year"
periodLength

string (int64 format)

Số kỳ hạn của gói thuê bao mà người mua phải trả.
amount

object (Price)

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

string

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

string (int64 format)

Điểm khách hàng thân thiết của nhà bán lẻ theo giá trị tuyệt đối.
ratio

number

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 (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Trường
programLabel

string

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

string

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

object (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

object (Price)

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

string (int64 format)

Số điểm khách hàng thân thiết nhận được khi mua hàng.

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

number

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

string

Bắt buộc. Các đơn vị thứ nguyên. Các giá trị được chấp nhận là: * "in" * "cm"

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

number

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

string

Bắt buộc. Đơn vị trọng lượng. Các giá trị được chấp nhận là: * "g" * "kg" * "oz" * "lb"

Vận chuyển

Thông tin vận chuyển sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Trường
price

object (Price)

Giá vận chuyển cố định, được thể hiện bằng một số.
country

string

Mã lãnh thổ CLDR của quốc gia mà mặt hàng sẽ được vận chuyển đến.
region

string

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

string

Nội dung mô tả ở dạng tự do về hạng dịch vụ hoặc tốc độ giao hàng.
locationId

string (int64 format)

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

string

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

string

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

string (int64 format)

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. Thuộc tính [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time]: giá trị này chỉ có thể xuất hiện khi có thuộc tính [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; nhưng không bắt buộc nếu có giá trị [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
maxHandlingTime

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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 (Price)
  }
}
Trường
country

string

Mã lãnh thổ CLDR của quốc gia mà mặt hàng sẽ được vận chuyển đến.
priceThreshold

object (Price)

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

number

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

string

Đơ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

number

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

string

Đơ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

number

Tỷ lệ phần trăm thuế suất áp dụng cho giá mặt hàng.
country

string

Quốc gia nơi mặt hàng bị đánh thuế, được chỉ định theo mã lãnh thổ CLDR.
region

string

Khu vực địa lý áp dụng thuế suất.
taxShip

boolean

Đặt thành true nếu tính thuế đối với phí vận chuyển.
locationId

string (int64 format)

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

string

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

number

Số đo của một mặt hàng.
unit

string

Đơ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

string (int64 format)

Mẫu số của đơn giá.
unit

string

Đơ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

string

Tiêu đề mục dùng để nhóm một bộ chi tiết sản phẩm.
attributeName

string

Tên chi tiết sản phẩm.
attributeValue

string

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 "Screen-Size" (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[]

string

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[]

string (int64 format)

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[]

number

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

string

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

boolean

Giá trị boolean của thuộc tính đã cho. Ví dụ: đối với một sản phẩm TV, "True" hoặc "False" nếu màn hình là UHD.
minValue

number

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

number

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

string

Đơ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.

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

string

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

string

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

string

Mã chứng nhận. Độ dài tối đa là 2000 ký tự.
certificationValue

string

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

string

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

string

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

string

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

string

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 (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Trường
destinationStatuses[]

object (DestinationStatus)

Vị trí xuất hiện dự kiến cho sản phẩm.
itemLevelIssues[]

object (ItemLevelIssue)

Danh sách tất cả các vấn đề liên quan đến sản phẩm.
creationDate

string (Timestamp format)

Ngày tạo mục, ở định dạng ISO 8601.
lastUpdateDate

string (Timestamp format)

Ngày cập nhật mục gần đây nhất, ở định dạng ISO 8601.
googleExpirationDate

string (Timestamp format)

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 (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Trường
reportingContext

enum (ReportingContextEnum)

Tên của ngữ cảnh báo cáo.
approvedCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi mặt hàng được phê duyệt.
pendingCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) có mặt hàng đang chờ phê duyệt.
disapprovedCountries[]

string

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 (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Trường
code

string

Mã lỗi của vấn đề.
severity

enum (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

string

Liệu người bán có thể giải quyết vấn đề này hay không.
attribute

string

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

enum (ReportingContextEnum)

Ngữ cảnh báo cáo áp dụng vấn đề.
description

string

Nội dung mô tả ngắn về vấn đề bằng tiếng Anh.
detail

string

Nội dung mô tả chi tiết về vấn đề bằng tiếng Anh.
documentation

string

URL của một trang web giúp giải quyết vấn đề này.
applicableCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) có vấn đề áp dụng 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

get

 Truy xuất sản phẩm đã xử lý từ tài khoản Merchant Center.

list

 Liệt kê các sản phẩm đã xử lý trong tài khoản Merchant Center của bạn.