本頁面由 Cloud Translation API 翻譯而成。

Package google.shopping.css.v1

索引

AccountLabelsService (介面)
AccountsService (介面)
CssProductInputsService (介面)
CssProductsService (介面)
QuotaService (介面)
Account (訊息)
Account.AccountType (列舉)
AccountLabel (訊息)
AccountLabel.LabelType (列舉)
Attributes (訊息)
Certification (訊息)
CreateAccountLabelRequest (訊息)
CssProduct (訊息)
CssProductInput (訊息)
CssProductStatus (訊息)
CssProductStatus.DestinationStatus (訊息)
CssProductStatus.ItemLevelIssue (訊息)
DeleteAccountLabelRequest (訊息)
DeleteCssProductInputRequest (訊息)
GetAccountRequest (訊息)
GetCssProductRequest (訊息)
HeadlineOfferInstallment (訊息)
HeadlineOfferSubscriptionCost (訊息)
InsertCssProductInputRequest (訊息)
ListAccountLabelsRequest (訊息)
ListAccountLabelsResponse (訊息)
ListChildAccountsRequest (訊息)
ListChildAccountsResponse (訊息)
ListCssProductsRequest (訊息)
ListCssProductsResponse (訊息)
ListQuotaGroupsRequest (訊息)
ListQuotaGroupsResponse (訊息)
MethodDetails (訊息)
ProductDetail (訊息)
ProductDimension (訊息)
ProductWeight (訊息)
QuotaGroup (訊息)
SubscriptionPeriod (列舉)
UpdateAccountLabelRequest (訊息)
UpdateAccountLabelsRequest (訊息)
UpdateCssProductInputRequest (訊息)

AccountLabelsService

管理 Merchant Center 和 CSS 帳戶標籤。

CreateAccountLabel

CreateAccountLabel
`rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)` 建立新標籤，但未指派給任何帳戶。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

建立新標籤，但未指派給任何帳戶。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

DeleteAccountLabel

DeleteAccountLabel
`rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)` 刪除標籤，並從所有已指派該標籤的帳戶中移除。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

刪除標籤，並從所有已指派該標籤的帳戶中移除。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

ListAccountLabels

ListAccountLabels
`rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)` 列出帳戶擁有的標籤。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

列出帳戶擁有的標籤。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

UpdateAccountLabel

UpdateAccountLabel
`rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)` 更新標籤。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

更新標籤。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

AccountsService

用於管理 CSS/MC 帳戶資訊的服務。

GetAccount

GetAccount
`rpc GetAccount(GetAccountRequest) returns (Account)` 根據 ID 擷取單一 CSS/MC 帳戶。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc GetAccount(GetAccountRequest) returns (Account)

根據 ID 擷取單一 CSS/MC 帳戶。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

ListChildAccounts

ListChildAccounts
`rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)` 列出指定 CSS 帳戶 ID 下的所有帳戶，並可視需要依標籤 ID 和帳戶名稱篩選。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

列出指定 CSS 帳戶 ID 下的所有帳戶，並可視需要依標籤 ID 和帳戶名稱篩選。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

UpdateLabels

UpdateLabels
`rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)` 更新 CSS 網域指派給 CSS/MC 帳戶的標籤。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

更新 CSS 網域指派給 CSS/MC 帳戶的標籤。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

CssProductInputsService

使用 CssProductInput 資源的服務。這項服務可協助你插入/更新/刪除 CSS 產品。

DeleteCssProductInput

DeleteCssProductInput
`rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)` 從 CSS Center 帳戶中刪除 CSS 產品輸入內容。刪除後，系統可能需要幾分鐘才能停止使用輸入內容。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

從 CSS Center 帳戶中刪除 CSS 產品輸入內容。

刪除後，系統可能需要幾分鐘才能停止使用輸入內容。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

InsertCssProductInput

InsertCssProductInput
`rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)` 將 CssProductInput 上傳至 CSS Center 帳戶。如果輸入內容的內容語言、身分、動態饋給標籤和動態饋給 ID 與現有項目相同，這個方法會取代該項目。插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘的時間才能擷取已處理的 CSS 產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

將 CssProductInput 上傳至 CSS Center 帳戶。如果輸入內容的內容語言、身分、動態饋給標籤和動態饋給 ID 與現有項目相同，這個方法會取代該項目。

插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘的時間才能擷取已處理的 CSS 產品。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

UpdateCssProductInput

UpdateCssProductInput
`rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)` 更新 CSS Center 帳戶中現有的 CSS 產品輸入內容。插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘才能擷取已處理的 CSS 產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

更新 CSS Center 帳戶中現有的 CSS 產品輸入內容。

插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘才能擷取已處理的 CSS 產品。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

CssProductsService

服務可用於取得及列出 CSS 產品(在內部稱為「匯總方案」)。

GetCssProduct

GetCssProduct
`rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)` 從 CSS Center 帳戶擷取已處理的 CSS 產品。插入、更新或刪除產品輸入內容後，可能需要幾分鐘才能擷取更新後的最終產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

從 CSS Center 帳戶擷取已處理的 CSS 產品。插入、更新或刪除產品輸入內容後，可能需要幾分鐘才能擷取更新後的最終產品。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

ListCssProducts

ListCssProducts
`rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)` 列出 CSS Center 帳戶中已處理的 CSS 產品。回應中項目的數量可能少於 pageSize 指定的數量。請依據 pageToken 判斷是否還有其他項目可要求。插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘的時間才能擷取更新後的已處理 CSS 產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

列出 CSS Center 帳戶中已處理的 CSS 產品。回應中項目的數量可能少於 pageSize 指定的數量。請依據 pageToken 判斷是否還有其他項目可要求。

插入、更新或刪除 CSS 產品輸入內容後，可能需要幾分鐘的時間才能擷取更新後的已處理 CSS 產品。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

QuotaService

服務，可依 CSS API 方法取得方法呼叫配額資訊。

ListQuotaGroups

ListQuotaGroups
`rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)` 列出 CSS Center 帳戶的每日呼叫配額和每個群組的用量。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 Overview。

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

列出 CSS Center 帳戶的每日呼叫配額和每個群組的用量。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/content

詳情請參閱 OAuth 2.0 Overview。

帳戶

CSS/MC 帳戶的相關資訊。

欄位
`name`	`string` 標籤資源名稱。格式：accounts/{account}
`full_name`	`string` 僅供輸出。不可變動。CSS/MC 帳戶的全名。
`label_ids[]`	`int64` 由 CSS 上層帳戶為 CSS/MC 帳戶指派的手動建立的標籤 ID。
`automatic_label_ids[]`	`int64` 由 CSS Center 自動建立並指派給 Merchant Center 帳戶的標籤 ID。
`account_type`	`AccountType` 僅供輸出。這個帳戶的類型。
`display_name`	`string` CSS/MC 帳戶的簡短顯示名稱。
`homepage_uri`	`string` 僅供輸出。不可變動。CSS/MC 帳戶的主頁。
`parent`	`string` CSS/MC 帳戶的上層資源。CSS 群組適用於 CSS 網域；CSS 網域適用於 MC 帳戶。只有在使用者擁有父項帳戶存取權時才會傳回。注意：對於 MC 子帳戶，這也是 CSS 網域，也是 MCA 帳戶的父項資源，因為我們實際上是將階層扁平化。」

AccountType

帳戶類型。

列舉
`ACCOUNT_TYPE_UNSPECIFIED`	不明的帳戶類型。
`CSS_GROUP`	CSS 群組帳戶。
`CSS_DOMAIN`	CSS 網域帳戶。
`MC_PRIMARY_CSS_MCA`	Merchant Center 主要 CSS MCA 帳戶。
`MC_CSS_MCA`	Merchant Center CSS MCA 帳戶。
`MC_MARKETPLACE_MCA`	Merchant Center 市集 MCA 帳戶。
`MC_OTHER_MCA`	MC 其他 MCA 帳戶。
`MC_STANDALONE`	Merchant Center 獨立帳戶。
`MC_MCA_SUBACCOUNT`	Merchant Center 多重客戶帳戶子帳戶。

AccountLabel

CSS 網域或 CSS 群組指派給其中一個子帳戶的標籤。

欄位
`name`	`string` ID。標籤的資源名稱。格式：accounts/{account}/labels/{label}
`label_id`	`int64` 僅供輸出。標籤的 ID。
`account_id`	`int64` 僅供輸出。此標籤所屬帳戶的 ID。
`label_type`	`LabelType` 僅供輸出。這個標籤的類型。
`display_name`	`string` 這個標籤的顯示名稱。
`description`	`string` 這個標籤的說明。

LabelType

標籤類型。

列舉
`LABEL_TYPE_UNSPECIFIED`	不明的標籤類型。
`MANUAL`	表示標籤是手動建立的。
`AUTOMATIC`	表示標籤是由 CSS Center 自動建立。

屬性

CSS 產品的屬性。

欄位
`low_price`	`Price` CSS 產品的低價。
`high_price`	`Price` CSS 產品的價格過高。
`headline_offer_price`	`Price` CSS 產品的主打價格。
`headline_offer_shipping_price`	`Price` CSS 產品的主打價格。
`additional_image_links[]`	`string` 商品圖片的其他網址。
`product_types[]`	`string` 商品類別 (格式請參閱產品資料規格)。
`size_types[]`	`string` 商品的裁剪方式。可用來代表服飾商品的組合尺寸類型。最多可提供兩種尺寸類型 (請參閱 [https://support.google.com/merchants/answer/6324497](尺寸類型))。
`product_details[]`	`ProductDetail` 技術規格或其他產品詳細資料。
`product_weight`	`ProductWeight` 產品的重量，以提供的單位表示。值必須介於 0 (不含) 和 2000 (含) 之間。
`product_length`	`ProductDimension` 產品長度 (以提供的單位表示)。值必須介於 0 (不含) 和 3000 (含) 之間。
`product_width`	`ProductDimension` 產品的寬度，以提供的單位表示。值必須介於 0 (不含) 和 3000 (含) 之間。
`product_height`	`ProductDimension` 產品高度，以提供的單位表示。值必須介於 0 (不含) 和 3000 (含) 之間。
`product_highlights[]`	`string` 產品最相關的亮點，以項目符號表示。
`certifications[]`	`Certification` CSS 為特定產品聲明的憑證清單。
`expiration_date`	`Timestamp` 商品到期的日期 (於插播時指定)，採用 ISO 8601 格式。實際到期日會在 `productstatuses` 中顯示為 googleExpirationDate，如果 `expirationDate` 距離現在太久，實際到期日可能會提前。注意：從到期日算起，可能需要 2 天以上，項目才會實際刪除。
`included_destinations[]`	`string` 要為此目標加入的目的地清單 (對應 Merchant Center 中勾選的核取方塊)。除非在 `excludedDestinations` 中提供，否則一律會加入預設目的地。
`excluded_destinations[]`	`string` 要為此目標排除的目的地清單 (對應 Merchant Center 中未勾選的核取方塊)。
`headline_offer_installment`	`HeadlineOfferInstallment` 購買商品時的期數和金額。
`headline_offer_subscription_cost`	`HeadlineOfferSubscriptionCost` 項目 (含相關訂閱合約) 的期數 (以月或年為單位) 和每期付款金額。
`cpp_link`	`string` 直接連結至 CSS 產品詳細資料頁面的網址。
`cpp_mobile_link`	`string` CSS 產品詳細資料頁面行動版的網址。
`cpp_ads_redirect`	`string` 當產品顯示在產品廣告的內容中時，廣告客戶可以覆寫商品網址。
`number_of_offers`	`int64` CSS 產品數量。
`headline_offer_condition`	`string` 主打商品的狀況。
`headline_offer_link`	`string` 主打商品連結。
`headline_offer_mobile_link`	`string` 主打商品的行動連結。
`title`	`string` 項目名稱。
`image_link`	`string` 商品圖片的網址。
`description`	`string` 項目說明。
`brand`	`string` 產品相關屬性。[14-36] 商品的品牌。
`mpn`	`string` 商品的製造商零件編號 (MPN)。
`gtin`	`string` 商品的全球交易品項識別碼 (GTIN)。
`google_product_category`	`string` Google 的商品類別 (請參閱「Google 產品分類」)。查詢產品時，這個欄位會包含使用者提供的值。目前無法透過 API 取得自動指派的 Google 產品類別。
`adult`	`bool` 如果是成人面向的商品，則設為 true。
`multipack`	`int64` 商家定義組合包中相同產品的數量。
`is_bundle`	`bool` 商品是否為商家定義的套裝組合。套裝組合是商家以單一價格出售的不同產品自訂組合。
`age_group`	`string` 商品的目標年齡層。
`color`	`string` 商品的顏色。
`gender`	`string` 商品的目標客群性別。
`material`	`string` 商品製造原料。
`pattern`	`string` 商品的圖案 (例如波卡圓點)。
`size`	`string` 商品尺寸。只能提供一個值。如果是尺寸不同的子類，請為每個尺寸插入個別產品，並使用相同的 `itemGroupId` 值 (請參閱 [https://support.google.com/merchants/answer/6324492](尺寸定義))。
`size_system`	`string` 指定尺寸的系統。建議用於服飾商品。
`item_group_id`	`string` 同一產品所有子類的共用 ID。
`pause`	`string` 這項商品的發布作業將暫時停止。
`custom_label_0`	`string` 自訂標籤 0：用於購物廣告活動中的商品自訂分組。
`custom_label_1`	`string` 自訂標籤 1：用於在購物廣告活動中自訂商品分組。
`custom_label_2`	`string` 自訂標籤 2：用於購物廣告活動中的商品自訂分組。
`custom_label_3`	`string` 自訂標籤 3：用於購物廣告活動中商品的自訂分組。
`custom_label_4`	`string` 自訂標籤 4：用於在購物廣告活動中自訂商品分組。

認證

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

欄位

欄位
`name`	`string` 認證名稱。目前最常見的值是「EPREL」，這個值代表歐盟的歐洲能源標籤註冊資料庫 (EPREL) 的能源效率認證。
`authority`	`string` 負責核發認證的發證機構或認證機構。目前最常見的值是「EC」或「European_Commission」，代表歐盟能源標章。
`code`	`string` 認證代碼。舉例來說，如果 EPREL 認證連結為 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456，認證號碼則為 123456。如使用歐洲能源標章，必須提供認證號碼。

name

string

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

authority

string

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

code

string

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

CreateAccountLabelRequest

針對「CreateAccountLanel」方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。上層帳戶。格式：accounts/{account}
`account_label`	`AccountLabel` 必要欄位。要建立的標籤。

parent

string

必要欄位。上層帳戶。格式：accounts/{account}

account_label

AccountLabel

必要欄位。要建立的標籤。

CssProduct

已處理的 CSS 產品。

欄位
`name`	`string` 購物比較服務產品的名稱。格式：`"accounts/{account}/cssProducts/{css_product}"`
`raw_provided_id`	`string` 僅供輸出。產品的專屬原始 ID。
`content_language`	`string` 僅供輸出。產品的雙字母 ISO 639-1 語言代碼。
`feed_label`	`string` 僅供輸出。產品的動態饋給標籤。
`attributes`	`Attributes` 僅供輸出。產品屬性清單。
`custom_attributes[]`	`CustomAttribute` 僅供輸出。自訂 (CSS 提供) 屬性清單。也可以用來以通用格式 (例如 `{ "name": "size type", "value": "regular" }`) 提交動態饋給規格中的任何屬性。這對於提交 API 未明確公開的屬性 (例如用於 Buy on Google 的額外屬性) 很有幫助。
`css_product_status`	`CssProductStatus` 僅供輸出。產品狀態、資料驗證問題，也就是以非同步方式計算的產品相關資訊。

CssProductInput

這個資源代表你為 CSS 產品提交的輸入資料，而非你在 CSS Center、購物廣告或 Google 跨平台顯示計畫中看到的已處理 CSS 產品。

欄位
`name`	`string` ID。購物比較服務產品輸入項目的名稱。格式：`accounts/{account}/cssProductInputs/{css_product_input}`，其中最後一個部分 `css_product_input` 包含 3 個部分：contentLanguage~feedLabel~offerId。範例：accounts/123/cssProductInputs/de~DE~rawProvidedId123
`final_name`	`string` 僅供輸出。已處理的 CSS 產品名稱。格式：`accounts/{account}/cssProducts/{css_product}` "
`raw_provided_id`	`string` 必要欄位。CSS 產品的專屬 ID。這項規則同樣適用於 CSS 產品輸入內容和已處理的 CSS 產品。我們只允許 ID 包含英數字元、底線和破折號。詳情請參閱產品動態饋給規格。
`content_language`	`string` 必要欄位。CSS 產品的雙字母 ISO 639-1 語言代碼。
`feed_label`	`string` 必要欄位。CSS 產品的動態饋給標籤。動態饋給標籤與「目標國家/地區」同義，因此應一律使用有效的區域代碼。例如：'DE' 代表德國，'FR' 代表法國。
`freshness_time (deprecated)`	`Timestamp` 這個項目已遭淘汰！已淘汰。請改用 expiration_date。代表 CSS 產品的現有版本 (新鮮度)，可用於在同時進行多項更新時，保留正確的順序。這個欄位不得設為未來時間。如果已設定，系統會在項目的最新版本已存在於系統中 (也就是現有 CSS 產品的最後更新時間晚於更新中設定的新鮮度時間) 時，防止更新。如果發生更新，系統會將上次更新時間設為這項新鮮度時間。如果未設定，系統不會阻止更新，且上次更新時間預設為 CSS API 收到這項要求的時間。如果作業遭到阻止，系統會擲回中止例外狀況。
`attributes`	`Attributes` CSS 產品屬性清單。
`custom_attributes[]`	`CustomAttribute` 自訂 (CSS 提供) 屬性清單。也可以用來以通用格式 (例如 `{ "name": "size type", "value": "regular" }`) 提交動態饋給規格中的任何屬性。這對於提交 API 未明確公開的屬性 (例如用於 Buy on Google 的額外屬性) 很有幫助。

CssProductStatus

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

欄位
`destination_statuses[]`	`DestinationStatus` 產品的預定目的地。
`item_level_issues[]`	`ItemLevelIssue` 與產品相關的所有問題清單。
`creation_date`	`Timestamp` 項目建立日期，採用 ISO 8601 格式。
`last_update_date`	`Timestamp` 項目上次更新的日期，採用 ISO 8601 格式。
`google_expiration_date`	`Timestamp` 項目到期日，採用 ISO 8601 格式。

DestinationStatus

產品狀態的目的狀態。

欄位
`destination`	`string` 目的地名稱
`approved_countries[]`	`string` CSS 產品已獲核准的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。
`pending_countries[]`	`string` CSS 產品尚待核准的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。
`disapproved_countries[]`	`string` CSS 產品遭拒登的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

ItemLevelIssue

產品狀態的 ItemLevelIssue。

欄位
`code`	`string` 問題的錯誤代碼。
`servability`	`string` 這個問題對 CSS 產品服務的影響程度。
`resolution`	`string` 商家是否可解決這個問題。
`attribute`	`string` 屬性名稱 (如果問題是因單一屬性造成)。
`destination`	`string` 問題適用的目的地。
`description`	`string` 問題的簡短英文說明。
`detail`	`string` 問題的詳細英文說明。
`documentation`	`string` 協助解決問題的說明網頁網址。
`applicable_countries[]`	`string` 問題適用於 CSS 產品的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

DeleteAccountLabelRequest

針對「DeleteAccountLabel」方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。要刪除的標籤名稱。格式：accounts/{account}/labels/{label}

name

string

必要欄位。要刪除的標籤名稱。格式：accounts/{account}/labels/{label}

DeleteCssProductInputRequest

DeleteCssProductInput 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。要刪除的 CSS 產品輸入資源名稱。格式：accounts/{account}/cssProductInputs/{css_product_input}，其中最後一個部分 `css_product_input` 包含 3 個部分：contentLanguage~feedLabel~offerId。範例：accounts/123/cssProductInputs/de~DE~rawProvidedId123
`supplemental_feed_id`	`int64` Content API 補充動態饋給 ID。如果動作套用至主要動態饋給，則不得設定這個欄位。如果已設定這個欄位，產品動作就會套用至補充動態饋給，而非主要 Content API 動態饋給。

name

string

必要欄位。要刪除的 CSS 產品輸入資源名稱。格式：accounts/{account}/cssProductInputs/{css_product_input}，其中最後一個部分 css_product_input 包含 3 個部分：contentLanguage~feedLabel~offerId。範例：accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

Content API 補充動態饋給 ID。如果動作套用至主要動態饋給，則不得設定這個欄位。如果已設定這個欄位，產品動作就會套用至補充動態饋給，而非主要 Content API 動態饋給。

GetAccountRequest

GetAccount 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。受管理的 CSS/MC 帳戶名稱。格式：accounts/{account}
`parent`	`string` (非必要) 只有在擷取 MC 帳戶資訊時才需要。做為 MC 帳戶上層資源的 CSS 網域。格式：accounts/{account}

name

string

必要欄位。受管理的 CSS/MC 帳戶名稱。格式：accounts/{account}

parent

string

(非必要) 只有在擷取 MC 帳戶資訊時才需要。做為 MC 帳戶上層資源的 CSS 網域。格式：accounts/{account}

GetCssProductRequest

GetCssProduct 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。要擷取的 CSS 產品名稱。

name

string

必要欄位。要擷取的 CSS 產品名稱。

HeadlineOfferInstallment

代表分期付款的訊息。

欄位

欄位
`months`	`int64` 買家須支付的期數。
`amount`	`Price` 買家每月須支付的金額。
`downpayment`	`Price` 買方必須預先支付的頭期款金額。

months

int64

買家須支付的期數。

amount

Price

買家每月須支付的金額。

downpayment

Price

買方必須預先支付的頭期款金額。

HeadlineOfferSubscriptionCost

產品的 SubscriptionCost。

欄位

欄位
`period`	`SubscriptionPeriod` 訂閱週期類型。支援的值如下： * "`month`" * "`year`"
`period_length`	`int64` 買家須支付款項的訂閱週期數。
`amount`	`Price` 買家每個訂閱期須支付的金額。

period

SubscriptionPeriod

訂閱週期類型。支援的值如下： * "month" * "year"

period_length

int64

買家須支付款項的訂閱週期數。

amount

Price

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

InsertCssProductInputRequest

針對 InsertCssProductInput 方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。這個 CSS 產品會插入的帳戶。格式：accounts/{account}
`css_product_input`	`CssProductInput` 必要欄位。要插入的 CSS 產品輸入內容。
`feed_id (deprecated)`	`int64` 這個項目已遭淘汰！ (非必要) 已淘汰。CSS 產品不需要動態饋給 ID。主要或補充動態饋給 ID。如果 CSS 產品已存在，且提供的動態饋給 ID 不同，CSS 產品會移至新的動態饋給。注意：目前 CSS 不需要提供動態饋給 ID，因為我們會即時建立動態饋給。我們目前尚未支援 CSS 產品的補充動態饋給。

parent

string

必要欄位。這個 CSS 產品會插入的帳戶。格式：accounts/{account}

css_product_input

CssProductInput

必要欄位。要插入的 CSS 產品輸入內容。

feed_id
(deprecated)

int64

(非必要) 已淘汰。CSS 產品不需要動態饋給 ID。主要或補充動態饋給 ID。如果 CSS 產品已存在，且提供的動態饋給 ID 不同，CSS 產品會移至新的動態饋給。注意：目前 CSS 不需要提供動態饋給 ID，因為我們會即時建立動態饋給。我們目前尚未支援 CSS 產品的補充動態饋給。

ListAccountLabelsRequest

ListAccountLabels 方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。上層帳戶。格式：accounts/{account}
`page_size`	`int32` 傳回的標籤數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個標籤。許可的最大值為 1000；超出的數值將一律指定為 1000。
`page_token`	`string` 屬於接收自前一個 `ListAccountLabels` 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時，提供至 `ListAccountLabels` 的所有其他參數須與提供網頁權杖的呼叫相符。

parent

string

必要欄位。上層帳戶。格式：accounts/{account}

page_size

int32

傳回的標籤數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個標籤。許可的最大值為 1000；超出的數值將一律指定為 1000。

page_token

string

屬於接收自前一個 ListAccountLabels 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListAccountLabels 的所有其他參數須與提供網頁權杖的呼叫相符。

ListAccountLabelsResponse

ListAccountLabels 方法的回應訊息。

欄位

欄位
`account_labels[]`	`AccountLabel` 指定帳戶的標籤。
`next_page_token`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

account_labels[]

AccountLabel

指定帳戶的標籤。

next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListChildAccountsRequest

ListChildAccounts 方法的要求訊息。

欄位
`parent`	`string` 必要欄位。上層帳戶。必須是 CSS 群組或網域。格式：accounts/{account}
`page_size`	`int32` (非必要) 要傳回的帳戶數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 50 個帳戶。許可的最大值為 100；超出的數值將一律指定為 100。
`page_token`	`string` (非必要) 屬於接收自前一個 `ListChildAccounts` 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時，提供至 `ListChildAccounts` 的所有其他參數須與提供網頁權杖的呼叫相符。
`label_id`	`int64` 如果已設定，系統只會傳回具有指定標籤 ID 的 MC 帳戶。
`full_name`	`string` 如果已設定，系統只會傳回名稱為指定名稱 (區分大小寫) 的 MC 帳戶。

ListChildAccountsResponse

ListChildAccounts 方法的回應訊息。

欄位

欄位
`accounts[]`	`Account` 系統為指定的 CSS 上層帳戶傳回的 CSS/MC 帳戶。
`next_page_token`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

accounts[]

Account

系統為指定的 CSS 上層帳戶傳回的 CSS/MC 帳戶。

next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListCssProductsRequest

ListCssProducts 方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。要列出已處理 CSS 產品的帳戶/網域。格式：accounts/{account}
`page_size`	`int32` 可指定傳回的 CSS 產品數量上限。服務傳回的產品數量可能會少於這個值。許可的最大值為 1000；超出的數值將一律指定為 1000。如未指定，系統會傳回 CSS 產品的數量上限。
`page_token`	`string` 屬於接收自前一個 `ListCssProducts` 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時，提供至 `ListCssProducts` 的所有其他參數須與提供網頁權杖的呼叫相符。

parent

string

必要欄位。要列出已處理 CSS 產品的帳戶/網域。格式：accounts/{account}

page_size

int32

可指定傳回的 CSS 產品數量上限。服務傳回的產品數量可能會少於這個值。許可的最大值為 1000；超出的數值將一律指定為 1000。如未指定，系統會傳回 CSS 產品的數量上限。

page_token

string

屬於接收自前一個 ListCssProducts 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListCssProducts 的所有其他參數須與提供網頁權杖的呼叫相符。

ListCssProductsResponse

ListCssProducts 方法的回應訊息。

欄位

欄位
`css_products[]`	`CssProduct` 指定帳戶中已處理的 CSS 產品。這些是套用規則和補充動態饋給後，系統處理過的 CSS 產品。
`next_page_token`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

css_products[]

CssProduct

指定帳戶中已處理的 CSS 產品。這些是套用規則和補充動態饋給後，系統處理過的 CSS 產品。

next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListQuotaGroupsRequest

ListQuotaGroups 方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。擁有方法配額和資源集合的 CSS 帳戶。在大多數情況下，這會是 CSS 網域。格式：accounts/{account}
`page_size`	`int32` (非必要) 回覆中傳回的配額數量上限，用於分頁。預設值為 500；超出的數值將一律指定為 1000。
`page_token`	`string` (非必要) 用於擷取後續網頁的符記 (如有提供)。所有其他參數都必須與提供網頁權杖的原始呼叫相符。

parent

string

必要欄位。擁有方法配額和資源集合的 CSS 帳戶。在大多數情況下，這會是 CSS 網域。格式：accounts/{account}

page_size

int32

(非必要) 回覆中傳回的配額數量上限，用於分頁。預設值為 500；超出的數值將一律指定為 1000。

page_token

string

(非必要) 用於擷取後續網頁的符記 (如有提供)。所有其他參數都必須與提供網頁權杖的原始呼叫相符。

ListQuotaGroupsResponse

ListMethodGroups 方法的回應訊息。

欄位

欄位
`quota_groups[]`	`QuotaGroup` 每個群組的方法、目前配額用量和限制。配額會在群組中的所有方法之間共用。群組會依據 `quota_usage` 以遞減順序排序。
`next_page_token`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

quota_groups[]

QuotaGroup

每個群組的方法、目前配額用量和限制。配額會在群組中的所有方法之間共用。群組會依據 quota_usage 以遞減順序排序。

next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

MethodDetails

CSS API 中每個方法的詳細資料。

欄位
`method`	`string` 僅供輸出。方法名稱，例如 `cssproductsservice.listcssproducts`。
`version`	`string` 僅供輸出。方法所屬的 API 版本。
`subapi`	`string` 僅供輸出。方法所屬的子 API。在 CSS API 中，這個值一律為 `css`。
`path`	`string` 僅供輸出。方法的路徑，例如 `v1/cssproductsservice.listcssproducts`。

ProductDetail

產品詳細資料。

欄位

欄位
`section_name`	`string` 用於將一組產品詳細資料分組的區段標題。
`attribute_name`	`string` 產品詳細資料的名稱。
`attribute_value`	`string` 產品詳細資料的值。

section_name

string

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

attribute_name

string

產品詳細資料的名稱。

attribute_value

string

產品詳細資料的值。

ProductDimension

產品的尺寸。

欄位

欄位
`value`	`double` 必要欄位。以數字表示的維度值。值的小數點後最多可有四位數。
`unit`	`string` 必要欄位。維度單位。可接受的值如下： * "`in`" * "`cm`"

value

double

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

unit

string

必要欄位。維度單位。可接受的值如下： * "in" * "cm"

ProductWeight

產品重量。

欄位

欄位
`value`	`double` 必要欄位。以數字表示的權重。權重的精確度最多可達小數點後四位。
`unit`	`string` 必要欄位。重量單位。可接受的值如下： * "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

必要欄位。以數字表示的權重。權重的精確度最多可達小數點後四位。

unit

string

必要欄位。重量單位。可接受的值如下： * "g" * "kg" * "oz" * "lb"

QuotaGroup

CSS API 中方法的群組資訊。配額會在群組中的所有方法之間共用。即使群組中沒有任何方法有用途，系統也會傳回群組的資訊。

欄位
`name`	`string` ID。配額群組的資源名稱。格式：accounts/{account}/quotas/{group} 範例：`accounts/12345678/quotas/css-products-insert` 注意：{group} 部分不保證會遵循特定模式。
`quota_usage`	`int64` 僅供輸出。目前的配額用量，也就是在特定一天內，對群組中方法所做的呼叫次數。每日配額限制會在世界標準時間下午 12 點重設。
`quota_limit`	`int64` 僅供輸出。群組每日允許的通話次數上限。
`quota_minute_limit`	`int64` 僅供輸出。群組每分鐘允許的呼叫數量上限。
`method_details[]`	`MethodDetails` 僅供輸出。列出適用於所有方法群組配額的項目。

SubscriptionPeriod

產品的訂閱期。

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

UpdateAccountLabelRequest

UpdateAccountLabel 方法的要求訊息。

欄位

欄位
`account_label`	`AccountLabel` 必要欄位。已更新的標籤。必須填妥所有欄位。

account_label

AccountLabel

必要欄位。已更新的標籤。必須填妥所有欄位。

UpdateAccountLabelsRequest

UpdateLabels 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。標籤資源名稱。格式：accounts/{account}
`label_ids[]`	`int64` 標籤 ID 清單，用於覆寫現有的帳戶標籤 ID。如果清單為空白，系統會刪除所有目前指派的標籤 ID。
`parent`	`string` (非必要) 只有在更新 MC 帳戶標籤時才需要。做為 MC 帳戶上層資源的 CSS 網域。格式：accounts/{account}

name

string

必要欄位。標籤資源名稱。格式：accounts/{account}

label_ids[]

int64

標籤 ID 清單，用於覆寫現有的帳戶標籤 ID。如果清單為空白，系統會刪除所有目前指派的標籤 ID。

parent

string

(非必要) 只有在更新 MC 帳戶標籤時才需要。做為 MC 帳戶上層資源的 CSS 網域。格式：accounts/{account}

UpdateCssProductInputRequest

UpdateCssProductInput 方法的要求訊息。

欄位

欄位
`css_product_input`	`CssProductInput` 必要欄位。要更新的 CSS 產品輸入資源。你提交的資訊也會套用至已處理的 CSS 產品。
`update_mask`	`FieldMask` 要更新的 CSS 產品屬性清單。如果略過更新遮罩，系統會將其視為隱含的欄位遮罩，等同於所有已填入資料的欄位 (具有非空值)。在更新遮罩中指定的屬性，如果在主體中未指定值，就會從 CSS 產品中刪除。更新遮罩只能指定屬性和自訂屬性中的頂層欄位。如要指定自訂屬性的更新遮罩，您必須加上 `custom_attribute.` 前置字串。系統不支援為完整 CSS 產品替換提供特殊的「*」值。

css_product_input

CssProductInput

必要欄位。要更新的 CSS 產品輸入資源。你提交的資訊也會套用至已處理的 CSS 產品。

update_mask

FieldMask

要更新的 CSS 產品屬性清單。

如果略過更新遮罩，系統會將其視為隱含的欄位遮罩，等同於所有已填入資料的欄位 (具有非空值)。

在更新遮罩中指定的屬性，如果在主體中未指定值，就會從 CSS 產品中刪除。

更新遮罩只能指定屬性和自訂屬性中的頂層欄位。

如要指定自訂屬性的更新遮罩，您必須加上 custom_attribute. 前置字串。

系統不支援為完整 CSS 產品替換提供特殊的「*」值。

Package google.shopping.css.v1 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

索引

AccountLabelsService

AccountsService

CssProductInputsService

CssProductsService

QuotaService

帳戶

AccountType

AccountLabel

LabelType

屬性

認證

CreateAccountLabelRequest

CssProduct

CssProductInput

CssProductStatus

DestinationStatus

ItemLevelIssue

DeleteAccountLabelRequest

DeleteCssProductInputRequest

GetAccountRequest

GetCssProductRequest

HeadlineOfferInstallment

HeadlineOfferSubscriptionCost

InsertCssProductInputRequest

ListAccountLabelsRequest

ListAccountLabelsResponse

ListChildAccountsRequest

ListChildAccountsResponse

ListCssProductsRequest

ListCssProductsResponse

ListQuotaGroupsRequest

ListQuotaGroupsResponse

MethodDetails

ProductDetail

ProductDimension

ProductWeight

QuotaGroup

SubscriptionPeriod

UpdateAccountLabelRequest

UpdateAccountLabelsRequest

UpdateCssProductInputRequest

Package google.shopping.css.v1