REST Resource: accounts.cssProducts

Tài nguyên: CssProduct

Sản phẩm CSS đã 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ô duy nhất của sản phẩm.
contentLanguage

string

Chỉ có đầu ra. Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 của 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 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ể 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 nguồn cấp dữ liệu ở dạng chung (ví dụ: { "name": "size type", "value": "regular" }). Thuộc tính này rất hữu ích khi gửi các thuộc tính không được API hiển thị 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ề việc 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 dáng của mặt hàng. Bạn có thể dùng thuộc tính này để thể hiện 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 hai 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ị đã 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ị đã 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ị đã 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ị đã 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 sản phẩm.
certifications[]

object (Certification)

Danh sách các giấy chứng nhận mà CSS đã xác nhận cho sản phẩm đã cho.
expirationDate

string (Timestamp format)

Ngày mà mặt hàng sẽ hết hạn, như đượ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 hơn 2 ngày kể từ ngày hết hạn thì mặt hàng mới thực sự bị xoá.
includedDestinations[]

string

Danh sách các vị trí xuất hiện 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í xuất hiện mặc định luôn được đưa vào trừ phi vị trí xuất hiện đó được cung cấp trong thuộc tính excludedDestinations.

Các giá trị được hỗ trợ: – css_ads_experiences – css_organic_experiences
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).

Các giá trị được hỗ trợ: – css_ads_experiences – css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

Số lần và số tiền trả góp 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 đối với một mặt hàng có hợp đồng thuê bao liên quan.
cppAdsRedirect

string

Cho phép nhà quảng cáo ghi đè URL của 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 mặt hàng theo Google (xem 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, bạn không thể lấy lại danh mục sản phẩm của Google được chỉ định tự động 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

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

string

Nhóm tuổi mà mặt hàng nhắm đến.
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 của 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 phép sử dụng 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 biệt cho mỗi kích thước có cùng giá trị itemGroupId (xem [https://support.google.com/merchants/answer/6324492](định nghĩa về kích thước)).
sizeSystem

string

Hệ thống mà kích thước được chỉ định. Nên dùng cho các mặt hàng quần áo.
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

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

string

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

string

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

string

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

string

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

string

Nhãn tuỳ chỉnh 4 để nhóm các mặt hàng theo cách tuỳ chỉnh trong 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.
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.
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.
rating

number

Điểm xếp hạng trung bình của sản phẩm. Giá trị phải nằm trong khoảng từ [minRating, maxRating], bao gồm 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 từ [1, 5] với một chữ số thập phân. Nếu bạn cung cấp, thì bạn cũng phải cung cấp reviewCount, minRating và maxRating.

Giá

Giá được thể hiện 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ố tính 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ền tệ chuẩn, 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á sử dụng từ viết tắt gồm ba 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 đề mục dùng để nhóm một tập hợp các chi tiết sản phẩm.
attributeName

string

Tên của 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. Cân nặng đượ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"

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à 4 chữ số thập phân.
unit

string

Bắt buộc. Đơn vị kích thước. Các 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 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ã là 123456. Đây là mã bắt buộc đối với nhãn năng lượng Châu Âu.

HeadlineOfferInstallment

Thông báo thể hiện chương trình 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ả trước.

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 kỳ thuê bao. 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 thanh toán.
amount

object (Price)

Số tiền mà người mua phải trả cho mỗi kỳ thuê bao.

SubscriptionPeriod

Thời hạn của gói thuê bao cho 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 kỳ thuê bao là tháng.
YEAR Cho biết kỳ thuê bao là năm.

CustomAttribute

Một thông báo đại diện cho các thuộc tính tùy chỉnh. Chỉ được để trống một trong hai trường 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)

Các 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ề việc 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 cho 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 mà mặt hàng hết hạn, ở định dạng ISO 8601.

DestinationStatus

Trạng thái của sản phẩm tại vị trí xuất hiện.

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 của 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

Liệu 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 gây ra.
destination

string

Đích đến có vấn đề.
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ấn đề bằng tiếng Anh.
documentation

string

URL của 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) nơi 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 của bạn.

list

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