Package google.shopping.css.v1

索引

AccountLabelsService

管理 Merchant Center 和 CSS 帳戶標籤。

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

列出帳戶擁有的標籤。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
UpdateAccountLabel

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

更新標籤。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

AccountsService

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

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

依 ID 擷取單一 CSS/MC 帳戶。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

CssProductInputsService

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

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

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

刪除後，輸入內容可能要過幾分鐘才會無法使用。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

CssProductsService

這項服務用於對 CSS 產品(內部稱為匯總供應項目) 執行取得和列出作業。

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。
ListCssProducts

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

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 群組；MC 帳戶的 CSS 網域。只有在使用者有權存取父項帳戶時才會傳回。注意：如果是 MC 子帳戶，這也是 MCA 帳戶的父項資源 CSS 網域，因為我們實際上會將階層扁平化。

AccountType

帳戶類型。

列舉
ACCOUNT_TYPE_UNSPECIFIED 帳戶類型不明。
CSS_GROUP CSS 群組帳戶。
CSS_DOMAIN CSS 網域帳戶。
MC_PRIMARY_CSS_MCA Merchant Center 主要 CSS MCA 帳戶。
MC_CSS_MCA MC CSS MCA 帳戶。
MC_MARKETPLACE_MCA MC Marketplace MCA 帳戶。
MC_OTHER_MCA MC Other MCA 帳戶。
MC_STANDALONE Merchant Center 獨立帳戶。
MC_MCA_SUBACCOUNT MC MCA 子帳戶。

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 產品的主打價格。
product_types[]

string

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

string

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

ProductDetail

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

ProductWeight

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

string

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

Certification

購物比較服務為指定產品聲明的認證清單。
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_ads_redirect

string

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

int64

CSS 產品數量。
headline_offer_condition

string

主打商品的狀況。
title

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。
review_count

int64

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

int64

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

int64

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

double

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

認證

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

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

必填。要建立的標籤。

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

購物比較服務產品屬性清單。
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

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

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

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 動態饋給。

GetAccountRequest

GetAccount 方法的要求訊息。

欄位
name

string

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

string

(選用步驟) 只有在擷取 MC 帳戶資訊時才需要提供。MC 帳戶的父項資源 CSS 網域。格式：accounts/{account}

GetCssProductRequest

GetCssProduct 方法的要求訊息。

欄位
name

string

必填。要擷取的 CSS 產品名稱。格式：accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

代表分期的訊息。

欄位
months

int64

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

Price

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

Price

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

HeadlineOfferSubscriptionCost

產品的 SubscriptionCost。

欄位
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 產品會移至新的動態饋給。注意：目前我們會在動態饋給建立時一併建立 ID，因此 CSS 無須提供動態饋給 ID。我們目前尚未支援 CSS 產品的補充動態饋給。

ListAccountLabelsRequest

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 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

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 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListCssProductsRequest

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 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ListQuotaGroupsRequest

ListQuotaGroups 方法的要求訊息。

欄位
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 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

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

產品詳細資料的值。

ProductDimension

產品尺寸。

欄位
value

double

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

string

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

ProductWeight

產品重量。

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

必填。更新後的標籤。所有欄位均為必填。

UpdateAccountLabelsRequest

UpdateLabels 方法的要求訊息。

欄位
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 產品更換作業提供特殊「*」值。