REST Resource: accounts.cssProducts

Tài nguyên: CssProduct

Sản phẩm CSS đã được xử lý.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Trường
name

string

Tên của sản phẩm CSS. Định dạng "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Chỉ có đầu ra. Giá trị nhận dạng thô riêng biệt của sản phẩm.
contentLanguage

string

Chỉ có đầu ra. Mã ngôn ngữ gồm 2 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 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 CSS cung cấp). Bạn cũng có thể dùng thuộc tính này để gửi mọi thuộc tính của quy cách nguồn cấp dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Điều này rất hữu ích khi gửi những thuộc tính mà API không công khai một cách rõ ràng, chẳng hạn như các thuộc tính bổ sung được dùng cho chương trình Mua trên Google.
cssProductStatus

object (CssProductStatus)

Chỉ có đầu ra. Trạng thái của một sản phẩm, các 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ộ.

Thuộc tính

Thuộc tính cho sản phẩm CSS.

Biểu diễn dưới dạng JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Trường
lowPrice

object (Price)

Giá thấp của sản phẩm CSS.
highPrice

object (Price)

Giá cao của sản phẩm CSS.
headlineOfferPrice

object (Price)

Giá trên tiêu đề của sản phẩm CSS.
headlineOfferShippingPrice

object (Price)

Giá trên tiêu đề của sản phẩm CSS.
productTypes[]

string

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

string

Kiểu cắt của mặt hàng. Bạn có thể dùng thuộc tính này để biểu thị các loại kích thước kết hợp cho mặt hàng quần áo. Bạn có thể cung cấp tối đa 2 loại kích thước (xem loại kích thước).
productDetails[]

object (ProductDetail)

Thông số kỹ thuật hoặc chi tiết sản phẩm bổ sung.
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).
productLength

object (ProductDimension)

Chiều dài 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).
productWidth

object (ProductDimension)

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).
productHeight

object (ProductDimension)

Chiều cao 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).
productHighlights[]

string

Các gạch đầu dòng mô tả những điểm nổi bật phù hợp nhất của một sản phẩm.
certifications[]

object (Certification)

Danh sách các chứng nhận mà CSS đã xác nhận quyền sở hữu cho sản phẩm nhất định.
expirationDate

string (Timestamp format)

Ngày hết hạn của mặt hàng (được 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 dưới dạng googleExpirationDate và có thể sớm hơn nếu expirationDate quá xa trong tương lai. Lưu ý: Có thể mất từ 2 ngày trở lên kể từ ngày hết hạn để mặt hàng thực sự bị xoá.
includedDestinations[]

string

Danh sách các vị trí cần thêm vào mục tiêu này (tương ứng với hộp kiểm được đánh dấu trong Merchant Center). Các vị trí mặc định luôn được đưa vào trừ phi vị trí đó được cung cấp trong excludedDestinations.
excludedDestinations[]

string

Danh sách các vị trí cần loại trừ khỏi mục tiêu này (tương ứng với hộp kiểm không được đánh dấu trong Merchant Center).
headlineOfferInstallment

object (HeadlineOfferInstallment)

Số lần và số tiền trả góp để thanh toán cho một mặt hàng.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Số kỳ hạn (tháng hoặc năm) và số tiền thanh toán cho mỗi kỳ hạn của một mặt hàng có hợp đồng thuê bao liên kết.
cppAdsRedirect

string

Cho phép nhà quảng cáo ghi đè URL mặt hàng khi sản phẩm xuất hiện trong bối cảnh của quảng cáo sản phẩm.
numberOfOffers

string (int64 format)

Số lượng sản phẩm CSS.
headlineOfferCondition

string

Tình trạng của ưu đãi trên tiêu đề.
title

string

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

string

Nội dung mô tả về mặt hàng.
brand

string

Thuộc tính liên quan đến sản phẩm.[14-36] Thương hiệu của 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.
gtin

string

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

string

Danh mục của Google đối với mặt hàng (xem cây 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 Google tự động chỉ định thông qua API.
adult

boolean

Đặt thành true nếu mặt hàng đó nhắm đến người lớn.
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.
isBundle

boolean

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 tuỳ chỉnh gồm nhiều sản phẩm do người bán bán với một mức giá duy nhất.
ageGroup

string

Nhóm tuổi mục tiêu của mặt hàng.
color

string

Màu sắc của mặt hàng.
gender

string

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

string

Chất liệu tạo nên mặt hàng.
pattern

string

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

string

Kích thước của mặt hàng. Bạn chỉ được thêm một giá trị. Đối với các biến thể có nhiều kích thước, 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 phần định nghĩa về kích thước [https://support.google.com/merchants/answer/6324492]).
sizeSystem

string

Hệ thống mà kích thước được chỉ định. Nên dùng cho các mặt hàng may mặc.
itemGroupId

string

Giá trị nhận dạng dùng chung cho tất cả các biến thể của cùng một sản phẩm.
pause

string

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

string

Nhãn tuỳ chỉnh 0 để nhóm tuỳ chỉnh các mặt hàng trong chiến dịch Mua sắm.
customLabel1

string

Nhãn tuỳ chỉnh 1 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
customLabel2

string

Nhãn tuỳ chỉnh 2 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
customLabel3

string

Nhãn tuỳ chỉnh 3 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
customLabel4

string

Nhãn tuỳ chỉnh 4 để nhóm tuỳ chỉnh các mặt hàng trong một chiến dịch Mua sắm.
reviewCount

string (int64 format)

Số lượng bài đánh giá về sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
minRating

string (int64 format)

Điểm xếp hạng tối thiểu của sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
maxRating

string (int64 format)

Điểm xếp hạng tối đa của sản phẩm. Bắt buộc nếu bạn cung cấp rating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.
rating

number

Điểm xếp hạng trung bình của sản phẩm. Giá trị phải nằm trong phạm vi [minRating, maxRating], kể cả hai giá trị này. Khi xuất hiện trên trang sản phẩm, điểm xếp hạng này được chuẩn hoá theo thang điểm [1, 5] với một chữ số thập phân. Nếu được cung cấp, bạn cũng phải có reviewCount, minRating và maxRating. Trường này dành cho một tính năng sắp ra mắt và hiện chưa được sử dụng.

Giá

Giá được biểu thị dưới dạng số và đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
Trường
amountMicros

string (int64 format)

Giá được biểu thị dưới dạng một số theo đơn vị một phần triệu (1 triệu đơn vị một phần triệu tương đương với một đơn vị tiêu chuẩn của đơn vị tiền tệ, ví dụ: 1 USD = 1.000.000 đơn vị một phần triệu).
currencyCode

string

Đơn vị tiền tệ của giá bằng chữ viết tắt gồm 3 chữ cái theo tiêu chuẩn ISO 4217.

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 đề của phần dùng để nhóm một bộ chi tiết sản phẩm.
attributeName

string

Tên của thông tin chi tiết sản phẩm.
attributeValue

string

Giá trị của chi tiết sản phẩm.

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 lượng được biểu thị dưới dạng một số. Trọng lượng 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. Giá trị được chấp nhận là: * "g" * "kg" * "oz" * "lb"

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 một số. Giá trị này 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ị phương diện. Giá trị được chấp nhận là: * "in" * "cm"

Giấy chứng nhận

Chứng nhận của sản phẩm. Sử dụng thuộc tính này để mô tả các chứng nhận, chẳng hạn như điểm xếp hạng hiệu suất năng lượng, có liên kết với một sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
Trường
name

string

Tên chứng nhận. Hiện tại, giá trị phổ biến nhất là "EPREL". Giá trị này thể hiện chứng nhận về hiệu quả về năng lượng trong cơ sở dữ liệu Cơ quan đăng ký nhãn năng lượng Châu Âu (EPREL) của Liên minh Châu Âu.
authority

string

Cơ quan hoặc tổ chức cấp chứng nhận chịu trách nhiệm về việc cấp chứng nhận. Hiện tại, giá trị phổ biến nhất là "EC" hoặc "European_Commission" cho nhãn năng lượng ở Liên minh Châu Âu.
code

string

Mã chứng nhận. Ví dụ: Đối với chứng nhận EPREL có đường liên kết https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, mã chứng nhận là 123456. Đây là mã bắt buộc đối với nhãn năng lượng Châu Âu.

HeadlineOfferInstallment

Một thông báo đại diện cho việc trả góp.

Biểu diễn dưới dạng JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
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 thanh toán ban đầu mà người mua phải trả.

HeadlineOfferSubscriptionCost

SubscriptionCost 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 chu kỳ đăng ký. Sau đây là các giá trị được hỗ trợ: * "month" * "year"
periodLength

string (int64 format)

Số kỳ hạn 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ỳ thuê bao.

SubscriptionPeriod

Kỳ hạn thuê bao của sản phẩm.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết rằng khoảng thời gian đăng ký không được chỉ định.
MONTH Cho biết rằng kỳ hạn thuê bao là tháng.
YEAR Cho biết rằng kỳ hạn thuê bao là năm.

CustomAttribute

Thông báo đại diện cho các thuộc tính tuỳ chỉnh. Bạn không được để trống đúng một trong hai thuộc tính value hoặc groupValues.

Biểu diễn dưới dạng JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Trường
groupValues[]

object (CustomAttribute)

Thuộc tính phụ trong nhóm thuộc tính này. Nếu groupValues không trống, thì value phải trống.
name

string

Tên của thuộc tính.
value

string

Giá trị của thuộc tính. Nếu value không trống, thì groupValues phải trống.

CssProductStatus

Trạng thái của Sản phẩm CSS, các vấn đề về xác thực dữ liệu, tức là thông tin về Sản phẩm CSS đượ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 của sản phẩm.
itemLevelIssues[]

object (ItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

Ngày cập nhật mặt hàng 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 của trạng thái sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Trường
destination

string

Tên của điểm đến
approvedCountries[]

string

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

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi Sản phẩm CSS đang chờ phê duyệt.
disapprovedCountries[]

string

Danh sách mã quốc gia (ISO 3166-1 alpha-2) nơi Sản phẩm CSS bị từ chối.

ItemLevelIssue

ItemLevelIssue của trạng thái sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Trường
code

string

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

string

Vấn đề này ảnh hưởng như thế nào đến việc phân phát Sản phẩm CSS.
resolution

string

Người bán có thể giải quyết vấn đề 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.
destination

string

Vị trí xuất hiện mà vấn đề áp dụng.
description

string

Nội dung mô tả ngắn gọ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) mà vấn đề áp dụng cho Sản phẩm CSS.

Phương thức

get

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

list

 Liệt kê các sản phẩm CSS đã được xử lý trong tài khoản CSS Center.