REST Resource: accounts.cssProducts

資源：CssProduct

處理後的 CSS 產品。

JSON 表示法 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
欄位
name

string

購物比較服務產品的名稱。格式："accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

僅供輸出。產品的專屬原始 ID。
contentLanguage

string

僅供輸出。產品的雙字母 ISO 639-1 語言代碼。
feedLabel

string

僅供輸出。產品的動態饋給標籤。
attributes

object (Attributes)

僅供輸出。產品屬性清單。
customAttributes[]

object (CustomAttribute)

僅供輸出。自訂 (CSS 提供) 屬性清單。你也可以使用這個方法，以一般形式提交動態饋給規格的任何屬性 (例如 { "name": "size type", "value": "regular" })。這有助於提交 API 未明確公開的屬性，例如用於 Buy on Google 的其他屬性。
cssProductStatus

object (CssProductStatus)

僅供輸出。產品狀態、資料驗證問題，也就是非同步計算的產品相關資訊。

屬性

CSS 產品的屬性。

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
}
欄位
lowPrice

object (Price)

CSS 產品的最低價格。
highPrice

object (Price)

CSS 產品價格偏高。
headlineOfferPrice

object (Price)

CSS 產品的主打價格。
headlineOfferShippingPrice

object (Price)

CSS 產品的主打價格。
productTypes[]

string

商品類別 (格式如產品資料規格)。
sizeTypes[]

string

商品切法。可用於表示服飾商品的組合尺寸類型。最多可提供兩種尺寸類型 (請參閱尺寸類型)。
productDetails[]

object (ProductDetail)

技術規格或其他產品詳細資料。
productWeight

object (ProductWeight)

產品重量，以提供的單位表示。值必須介於 0 (不含) 和 2000 (含) 之間。
productLength

object (ProductDimension)

產品長度，以提供的單位為準。這個值必須介於 0 至 3000 之間 (大於 0，且不超過上限值)。
productWidth

object (ProductDimension)

產品寬度，單位為所提供的單位。這個值必須介於 0 至 3000 之間 (大於 0，且不超過上限值)。
productHeight

object (ProductDimension)

產品高度，以提供的單位表示。這個值必須介於 0 至 3000 之間 (大於 0，且不超過上限值)。
productHighlights[]

string

條列式說明產品最相關的亮點。
certifications[]

object (Certification)

購物比較服務為指定產品聲明的認證清單。
expirationDate

string (Timestamp format)

商品到期的日期 (於插播時指定)，採用 ISO 8601 格式。實際到期日會以 productstatuses 中的 googleExpirationDate 顯示，如果 expirationDate 距離現在太久，實際到期日可能會提前。注意：商品可能在到期日後 2 天以上才會實際刪除。
includedDestinations[]

string

要為此目標加入的目的地清單 (對應 Merchant Center 中勾選的核取方塊)。除非 excludedDestinations 中有說明，否則一律會加入預設目的地。
excludedDestinations[]

string

要為此目標排除的目的地清單 (對應 Merchant Center 中未勾選的核取方塊)。
headlineOfferInstallment

object (HeadlineOfferInstallment)

商品應付期數和金額。
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

與訂閱合約相關聯的項目期數 (月或年) 和每期付款金額。
cppAdsRedirect

string

廣告主可以在產品廣告的環境中顯示產品時，覆寫項目網址。
numberOfOffers

string (int64 format)

CSS 產品數量。
headlineOfferCondition

string

主打商品的狀況。
title

string

項目的名稱。
description

string

商品說明。
brand

string

產品相關屬性。[14-36] 商品品牌。
mpn

string

商品的製造商零件編號 (MPN)。
gtin

string

商品的全球交易品項識別碼 (GTIN)。
googleProductCategory

string

商品的 Google 類別 (請參閱 Google 產品分類)。查詢產品時，這個欄位會包含使用者提供的值。目前無法透過 API 取得自動指派的 Google 產品類別。
adult

boolean

如果是成人面向的商品，則設為 true。
multipack

string (int64 format)

商家定義組合包中同款產品的數量。
isBundle

boolean

商品是否為商家定義的套裝組合。套裝組合是指商家自訂的不同產品組合，並以單一價格出售。
ageGroup

string

商品的目標年齡層。
color

string

商品顏色。
gender

string

商品的目標客群性別。
material

string

商品製造原料。
pattern

string

商品的圖案 (例如波爾卡點)。
size

string

商品尺寸。只能輸入一個值。如果子類有不同尺寸，請為每個尺寸插入個別產品，並使用相同的 itemGroupId 值 (請參閱 [https://support.google.com/merchants/answer/6324492](尺寸定義))。
sizeSystem

string

指定尺寸的系統。建議用於服飾商品。
itemGroupId

string

同一產品所有子類的共用 ID。
pause

string

這項商品將暫時停止發布。
customLabel0

string

購物廣告活動中商品自訂分組的自訂標籤 0。
customLabel1

string

購物廣告活動中商品自訂分組的自訂標籤 1。
customLabel2

string

購物廣告活動中商品自訂分組的自訂標籤 2。
customLabel3

string

購物廣告活動中商品自訂分組的自訂標籤 3。
customLabel4

string

購物廣告活動中商品自訂分組的自訂標籤 4。
reviewCount

string (int64 format)

產品的評論數量。如果提供 rating，則為必要欄位。這個欄位適用於即將推出的功能，目前尚未啟用。
minRating

string (int64 format)

產品的最低評分。如果提供 rating，則為必要欄位。這個欄位適用於即將推出的功能，目前尚未啟用。
maxRating

string (int64 format)

產品的最高評分。如果提供 rating，則為必要欄位。這個欄位適用於即將推出的功能，目前尚未啟用。
rating

number

產品的平均評分。值必須介於 [minRating, maxRating] 之間，在產品頁面上顯示時，這項評分會標準化為 [1, 5] 範圍，並顯示到小數點後一位。如果提供，則也必須提供 reviewCount、minRating 和 maxRating。這個欄位適用於即將推出的功能，目前尚未啟用。

價格

以數字和幣別表示的價格。

JSON 表示法 
{
  "amountMicros": string,
  "currencyCode": string
}
欄位
amountMicros

string (int64 format)

以微量單位表示的價格 (100 萬微量單位等於一個貨幣標準單位，例如 1 美元 = 100 萬微量單位)。
currencyCode

string

價格的幣別，採用 ISO 4217 規定的三個英文字母縮寫。

ProductDetail

產品詳細資料。

JSON 表示法 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
欄位
sectionName

string

用於將一組產品詳細資料分組的區段標題。
attributeName

string

產品詳細資料的名稱。
attributeValue

string

產品詳細資料的值。

ProductWeight

產品重量。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

必填。以數字表示的權重。重量最多可精確至小數點後四位。
unit

string

必填。重量單位。可接受的值包括： *「g」 *「kg」 *「oz」 *「lb」

ProductDimension

產品尺寸。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

必填。以數字表示的維度值。值的小數點後最多可有四位數。
unit

string

必填。維度單位。可接受的值包括： *「in」 *「cm」

認證

產品認證。使用這項屬性說明產品相關認證，例如能源效率等級。

JSON 表示法 
{
  "name": string,
  "authority": string,
  "code": string
}
欄位
name

string

認證名稱。目前最常見的值是「EPREL」，這個值代表歐盟歐洲能源標籤註冊資料庫 (EPREL) 的能源效率認證。
authority

string

負責核發認證的發證機構或認證機構。目前最常見的值是「EC」或「European_Commission」，代表歐盟能源標章。
code

string

認證代碼。舉例來說，如果 EPREL 認證連結為 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456，認證號碼則為 123456。如使用歐洲能源標章，必須提供認證號碼。

HeadlineOfferInstallment

代表分期的訊息。

JSON 表示法 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
欄位
months

string (int64 format)

買家須支付款項的期數。
amount

object (Price)

買家每月須支付的金額。
downpayment

object (Price)

買家須支付的頭期款金額。

HeadlineOfferSubscriptionCost

產品的 SubscriptionCost。

JSON 表示法 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
欄位
period

enum (SubscriptionPeriod)

訂閱週期類型。支援的值包括： *「month」 *「year」
periodLength

string (int64 format)

買家須支付費用的訂閱週期總數。
amount

object (Price)

買家在每個訂閱週期須支付的金額。

SubscriptionPeriod

產品的訂閱週期。

列舉
SUBSCRIPTION_PERIOD_UNSPECIFIED 表示未指定訂閱期。
MONTH 表示訂閱週期為一個月。
YEAR 表示訂閱週期為一年。

CustomAttribute

代表自訂屬性的訊息。value 或 groupValues 必須有一個不為空。

JSON 表示法 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
欄位
groupValues[]

object (CustomAttribute)

這個屬性群組中的子屬性。如果 groupValues 不為空白，value 就必須為空白。
name

string

屬性名稱。
value

string

屬性的值。如果 value 不為空白，groupValues 就必須為空白。

CssProductStatus

Css 產品的狀態、資料驗證問題，也就是非同步計算的 Css 產品相關資訊。

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
欄位
destinationStatuses[]

object (DestinationStatus)

產品的預定目的地。
itemLevelIssues[]

object (ItemLevelIssue)

與產品相關的所有問題清單。
creationDate

string (Timestamp format)

項目建立日期，採用 ISO 8601 格式。
lastUpdateDate

string (Timestamp format)

商品上次更新的日期，採用 ISO 8601 格式。
googleExpirationDate

string (Timestamp format)

商品到期日，採用 ISO 8601 格式。

DestinationStatus

產品狀態的目的地狀態。

JSON 表示法 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
欄位
destination

string

目的地名稱
approvedCountries[]

string

CSS 產品獲得核准的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
pendingCountries[]

string

CSS 產品待核准的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
disapprovedCountries[]

string

CSS 產品遭拒登的國家/地區代碼清單 (ISO 3166-1 alpha-2)。

ItemLevelIssue

產品狀態的項目層級問題。

JSON 表示法 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
欄位
code

string

問題的錯誤代碼。
servability

string

這個問題對 CSS 產品放送的影響程度。
resolution

string

商家是否可解決這個問題。
attribute

string

屬性名稱 (如果問題是因單一屬性造成)。
destination

string

問題適用的目的地。
description

string

問題的簡短英文說明。
detail

string

問題的詳細英文說明。
documentation

string

協助解決問題的說明網頁網址。
applicableCountries[]

string

問題適用的 CSS 產品國家/地區代碼清單 (ISO 3166-1 alpha-2)。

方法

get

 從 CSS Center 帳戶擷取已處理的 CSS 產品。

list

 列出 CSS Center 帳戶中已處理的 CSS 產品。