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ô duy nhất của bạn cho sản phẩm.

contentLanguage

string

Chỉ có đầu ra. Mã ngôn ngữ ISO 639-1 gồm hai chữ cái của sản phẩm.

feedLabel

string

Chỉ có đầu ra. Nhãn nguồn cấp dữ liệu cho 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 bất kỳ thuộc tính nào của thông số kỹ thuật 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 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 dùng cho chương trình Mua trên Google.

cssProductStatus

object (CssProductStatus)

Chỉ có đầu ra. Trạng thái của sản phẩm, vấn đề về việc xác thực dữ liệu, tức là thông tin về 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
}
Trường
lowPrice

object (Price)

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

highPrice

object (Price)

Giá sản phẩm CSS cao.

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 các 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 [https://support.google.com/merchants/answer/6324497](loại kích thước)).

productDetails[]

object (ProductDetail)

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

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 dấu đầ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 chứng chỉ mà CSS xác nhận quyền sở hữu cho một sản phẩm nhất định.

expirationDate

string (Timestamp format)

Ngày hết hạn của mặt hàng, 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ục đó mới 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 đánh dấu trong Merchant Center). Các đích đến mặc định luôn được đưa vào trừ phi đích đến đó đượ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 đánh dấu không được chọn trong Merchant Center).

headlineOfferInstallment

object (HeadlineOfferInstallment)

Số lượng 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 kết.

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 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 các danh mục sản phẩm của Google được chỉ định tự động thông qua API.

adult

boolean

Đặt thành đúng nếu mục đó 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 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à mặt hàng nhắm đến.

material

string

Chất liệu làm 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. Chỉ được 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 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 chỉ định kích thước. 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 dừng.

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.

Giá

Giá được biểu diễ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 số theo micro (1 triệu micro tương đương với một đơn vị tiền tệ tiêu chuẩn, ví dụ: 1 USD = 1.000.000 micro).

currencyCode

string

Đơn vị tiền tệ của giá bán, sử dụng từ viết tắt gồm ba chữ cái theo ISO 4217.

ProductDetail

Thông tin chi tiết về 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 thông tin chi tiết về 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. Trọng số được biểu diễn dưới dạng số. Độ chính xác tối đa của trọng số 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 diễn 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ị phương diện. Các giá trị được chấp nhận là: * "in" * "cm"

Giấy chứng nhận

Giấy chứng nhận cho 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 suất 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 chỉ 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

Thông báo đại diện cho khoản 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 trả trước 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 thời hạn thuê bao. Các giá trị được hỗ trợ là: * "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

Thời hạn thuê bao của sản phẩm.

Enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Cho biết thời hạn thuê bao chưa được chỉ định.
MONTH Cho biết thời hạn thuê bao là tháng.
YEAR Cho biết thời 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. Phải có đúng một trong hai value hoặc groupValues không được để trống.

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, value phải trống.

name

string

Tên thuộc tính.

value

string

Giá trị của thuộc tính. Nếu value không trống, 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)

Đích đế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ụ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 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 đích đế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

Mức độ ảnh hưởng của vấn đề này đế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 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 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.