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

Package google.shopping.merchant.products.v1beta

索引

ProductInputsService (介面)
ProductsService (介面)
Attributes (訊息)
Certification (訊息)
CloudExportAdditionalProperties (訊息)
DeleteProductInputRequest (訊息)
FreeShippingThreshold (訊息)
GetProductRequest (訊息)
InsertProductInputRequest (訊息)
Installment (訊息)
ListProductsRequest (訊息)
ListProductsResponse (訊息)
LoyaltyPoints (訊息)
LoyaltyProgram (訊息)
Product (訊息)
ProductDetail (訊息)
ProductDimension (訊息)
ProductInput (訊息)
ProductStatus (訊息)
ProductStatus.DestinationStatus (訊息)
ProductStatus.ItemLevelIssue (訊息)
ProductStatus.ItemLevelIssue.Severity (列舉)
ProductStructuredDescription (訊息)
ProductStructuredTitle (訊息)
ProductWeight (訊息)
Shipping (訊息)
ShippingDimension (訊息)
ShippingWeight (訊息)
SubscriptionCost (訊息)
SubscriptionPeriod (列舉)
Tax (訊息)
UnitPricingBaseMeasure (訊息)
UnitPricingMeasure (訊息)

ProductInputsService

要使用 ProductInput 資源的服務。這項服務僅適用於擁有線上通路的產品。

DeleteProductInput

DeleteProductInput
`rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)` 從 Merchant Center 帳戶中刪除產品輸入內容。插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取已處理的產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 總覽。

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

InsertProductInput

InsertProductInput
`rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)` 將產品輸入資料上傳至 Merchant Center 帳戶。如果已有具有相同 contentLanguage、offerId 和 dataSource 的輸入內容，這個方法會取代該項目。插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取已處理的產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 總覽。

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

將產品輸入資料上傳至 Merchant Center 帳戶。如果已有具有相同 contentLanguage、offerId 和 dataSource 的輸入內容，這個方法會取代該項目。

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ProductsService

使用產品資源的服務。這項服務僅適用於擁有線上通路的產品。

GetProduct

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

rpc GetProduct(GetProductRequest) returns (Product)

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

插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取更新後的最終產品。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ListProducts

ListProducts
`rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)` 請在 Merchant Center 帳戶中列出已處理的產品。回應包含的項目可能少於 pageSize 指定的項目。依據 pageToken 判斷是否有更多要求的項目。插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取更新後的已處理產品。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/content` 詳情請參閱 OAuth 2.0 總覽。

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

請在 Merchant Center 帳戶中列出已處理的產品。回應包含的項目可能少於 pageSize 指定的項目。依據 pageToken 判斷是否有更多要求的項目。

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

屬性

屬性。

欄位
`additional_image_links[]`	`string` 項目圖片的其他網址。
`expiration_date`	`Timestamp` 商品的到期日 (在插入時指定，採用 ISO 8601 格式)。實際到期日會在 `productstatuses` 中顯示為 googleExpirationDate，如果 `expirationDate` 距離現在太久，可能會更早。
`disclosure_date`	`Timestamp` 商品在 Google 各項 YouTube 平台搜尋結果中顯示的日期時間 (採用 ISO 8601 格式)。詳情請參閱 [揭露日期]( https://support.google.com/merchants/answer/13034208)。
`availability_date`	`Timestamp` 預購產品可出貨的日期 (採用 ISO 8601 格式)。
`price`	`Price` 商品的價格。
`installment`	`Installment` 為單一商品支付的分期付款金額和金額。
`subscription_cost`	`SubscriptionCost` 相關訂閱合約的每期付款週期數 (單位為月或年) 與付款金額。
`loyalty_points`	`LoyaltyPoints` 使用者購買商品後獲得的會員點數。僅限日本。
`loyalty_programs[]`	`LoyaltyProgram` 會員方案資訊，用來向商品的使用者顯示會員福利，例如更優惠的價格、點數等。
`product_types[]`	`string` 商品類別 (格式為產品資料規格)。
`sale_price`	`Price` 商品的廣告特價。
`sale_price_effective_date`	`Interval` 商品特價的日期範圍 (請參閱產品資料規格)。
`product_height`	`ProductDimension` 產品高度，以提供的單位表示。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。
`product_length`	`ProductDimension` 產品長度 (以提供的單位表示)。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。
`product_width`	`ProductDimension` 產品寬度，以提供的單位表示。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。
`product_weight`	`ProductWeight` 以單位提供的產品重量表示產品重量。這個值必須介於 0 至 2000 之間 (不含 0 和 2000)。
`shipping[]`	`Shipping` 運送規則。
`free_shipping_threshold[]`	`FreeShippingThreshold` 產品必須符合免運費條件才能享有免運費優惠。
`shipping_weight`	`ShippingWeight` 商品運送包裹重量。
`shipping_length`	`ShippingDimension` 運送項目的長度。
`shipping_width`	`ShippingDimension` 運送項目的寬度。
`shipping_height`	`ShippingDimension` 運送商品的高度。
`size_types[]`	`string` 項目剪裁。此屬性可用於表示服飾商品的綜合尺寸類型。最多可以提供兩種尺寸類型 (請參閱 [https://support.google.com/merchants/answer/6324497](尺寸類型))。
`taxes[]`	`Tax` 稅務資訊。
`unit_pricing_measure`	`UnitPricingMeasure` 商品的度量和尺寸。
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` 單位價格的分母。
`ads_labels[]`	`string` 與 ads_grouping 類似，但只適用於單次點擊出價。
`cost_of_goods_sold`	`Price` 銷貨成本。用於回報毛利。
`product_details[]`	`ProductDetail` 技術規格或其他產品詳細資料。
`product_highlights[]`	`string` 用條列式說明產品最相關的亮點。
`display_ads_similar_ids[]`	`string` 廣告主指定的建議。
`promotion_ids[]`	`string` 促銷活動的專屬 ID。
`included_destinations[]`	`string` 要為這個目標加入的目的地清單 (對應 Merchant Center 中勾選的核取方塊)。除非 `excludedDestinations` 中有提供預設目的地，否則一律會納入預設目的地。
`excluded_destinations[]`	`string` 要為這個目標排除的目的地清單 (對應 Merchant Center 中取消勾選的核取方塊)。
`shopping_ads_excluded_countries[]`	`string` 要從購物廣告到達網頁中排除的商品國家/地區代碼清單 (ISO 3166-1 alpha-2)。系統會從資料來源設定中所設的國家/地區移除這份清單中的國家/地區。
`lifestyle_image_links[]`	`string` 商品生活風格圖片的其他網址，用來明確識別在實際環境中呈現您商品的圖片。詳情請參閱說明中心文章。
`cloud_export_additional_properties[]`	`CloudExportAdditionalProperties` 要匯出至 Cloud Retail 計畫的額外欄位。
`certifications[]`	`Certification` 產品認證，例如為歐盟 EPREL 資料庫中記錄的產品，為能源效率加上標籤。詳情請參閱說明中心文章。
`auto_pricing_min_price`	`Price` 「自動折扣」(https://support.google.com/merchants/answer/10295759) 和「動態促銷活動」(https://support.google.com/merchants/answer/13949249) 專案中的保護措施，確保商家優惠的折扣不會低於這個值，進而保障優惠價值和獲利能力。
`identifier_exists`	`bool` 如果商品沒有符合所屬類別的專屬產品 ID (例如全球交易品項識別碼、製造商零件編號和品牌)，請將這個值設為 false。如未提供，預設為 true。
`is_bundle`	`bool` 商品是否為商家定義的套裝組合。套裝組合是指商家以單一價格販售的各種不同產品的自訂分組。
`title`	`string` 項目的名稱。
`description`	`string` 商品說明。
`link`	`string` 直接連結至網路商店中商品頁面的網址。
`mobile_link`	`string` 針對行動裝置最佳化的商品到達網頁版本網址。
`canonical_link`	`string` 商品到達網頁的標準版本網址。
`image_link`	`string` 商品圖片的網址。
`adult`	`bool` 如果該項目是以成人為目標對象，則設為 true。
`age_group`	`string` 商品的指定年齡層。
`availability`	`string` 商品的供應情形狀態。
`brand`	`string` 商品的品牌。
`color`	`string` 項目顏色。
`condition`	`string` 商品的狀況或狀態。
`gender`	`string` 項目的目標性別。
`google_product_category`	`string` 商品的 Google 類別 (請參閱 Google 產品分類)。查詢產品時，這個欄位會包含使用者提供的值。目前無法透過 API 取回系統自動指派的 Google 產品類別。
`gtin`	`string` 商品的全球交易品項識別碼 (GTIN)。
`item_group_id`	`string` 同一產品所有子類的共用 ID。
`material`	`string` 物品的材質。
`mpn`	`string` 商品的製造商零件編號 (MPN)。
`pattern`	`string` 項目的圖案 (例如波卡圓點)。
`sell_on_google_quantity`	`int64` 在 Google 上販售的產品數量。僅適用於線上產品。
`max_handling_time`	`int64` 產品處理時間最長 (以工作天計)。
`min_handling_time`	`int64` 最短的產品處理時間 (以工作天計)。
`shipping_label`	`string` 產品的運送標籤，用於在帳戶層級運送規則中將產品分類。
`transit_time_label`	`string` 產品的運送時間標籤，用於在帳戶層級的運送時間表格中將產品分組。
`size`	`string` 商品尺寸。只能輸入一個值。如果是具有不同尺寸的子類，請為每個尺寸插入不同的產品，並加入相同的 `itemGroupId` 值 (請參閱 [https://support.google.com/merchants/answer/6324492](尺寸定義))。
`size_system`	`string` 指定大小的系統。建議用於服飾商品。
`tax_category`	`string` 產品的稅目，用於在帳戶層級的稅金設定中設置詳細的稅務課稅關聯。
`energy_efficiency_class`	`string` 歐盟指令 2010/30/EU 中定義的能源效率等級。
`min_energy_efficiency_class`	`string` 歐盟指令 2010/30/EU 中定義的能源效率等級。
`max_energy_efficiency_class`	`string` 歐盟指令 2010/30/EU 中定義的能源效率等級。
`multipack`	`int64` 同一款產品在商家定義組合包中的數量。
`ads_grouping`	`string` 可使用任意方式將項目分組，僅適用於單次轉換百分比，否則不建議使用。
`ads_redirect`	`string` 允許廣告主在產品廣告顯示時覆寫商品網址。
`display_ads_id`	`string` 動態再行銷廣告活動項目的 ID。
`display_ads_title`	`string` 動態再行銷廣告活動項目的名稱。
`display_ads_link`	`string` 直接連往動態再行銷廣告活動項目的到達網頁網址。
`display_ads_value`	`double` 提供動態再行銷廣告活動利潤。
`pickup_method`	`string` 商品的取貨選項。
`pickup_sla`	`string` 商品的到店取貨時間。
`link_template`	`string` 商家代管的本地店面連結範本。
`mobile_link_template`	`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。
`external_seller_id`	`string` 以多重賣方帳戶來說，此為必填屬性。如果您是會將不同賣家的產品上傳至多重賣家帳戶的市集，請使用這項屬性。
`pause`	`string` 系統會暫時暫停發布這個項目。
`virtual_model_link`	`string` 商品的 3D 圖片網址。詳情請參閱說明中心文章。
`structured_title`	`ProductStructuredTitle` 結構化標題，適用於透過演算法 (AI) 生成的標題。
`structured_description`	`ProductStructuredDescription` 結構化說明：適用於演算法 (AI) 生成的說明。

認證

產品認證，最初是依據歐盟 EPREL 資料庫遵循歐盟能源效率標籤法規而推出。

欄位
`certification_authority`	`string` 發證機構，例如「European_Commission」。長度上限為 2000 個半形字元。
`certification_name`	`string` 證照的名稱，例如「EPREL」。長度上限為 2000 個半形字元。
`certification_code`	`string` 證照號碼。長度上限為 2000 個半形字元。
`certification_value`	`string` 證照值 (又稱等級、等級或成績)，例如「A+」、「C」、「黃金」。長度上限為 2000 個半形字元。

CloudExportAdditionalProperties

Cloud Retail API 的產品屬性。舉例來說，電視產品的屬性可以是「螢幕解析度」或「螢幕尺寸」。

欄位
`text_value[]`	`string` 指定屬性的文字值。舉例來說，「8K(UHD)」可以是電視產品的文字值。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存，字串大小上限為 256 個字元。
`int_value[]`	`int64` 指定屬性的整數值。例如，電視產品的螢幕解析度為 1080。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存，
`float_value[]`	`float` 指定屬性的浮點值。以電視產品 1.2345 為例。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存，
`property_name`	`string` 指定屬性的名稱。例如電視產品的「螢幕解析度」。字串大小上限為 256 個字元。
`bool_value`	`bool` 指定屬性的布林值。舉例來說，如果是電視產品，螢幕為 UHD 時，請設為「True」或「False」。
`min_value`	`float` 指定屬性的最小浮點數值。以電視產品 1.00 為例。
`max_value`	`float` 指定屬性的浮點值上限。例如電視產品 100.00。
`unit_code`	`string` 指定屬性的單位。舉例來說，如果電視產品是「像素」，字串大小上限為 256B。

DeleteProductInputRequest

DeleteProductInput 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。要刪除的產品輸入資源名稱。格式：accounts/{account}/productInputs/{product}
`data_source`	`string` 必要欄位。應刪除產品輸入內容的主要或補充資料來源。格式：`accounts/{account}/dataSources/{datasource}`。

name

string

必要欄位。要刪除的產品輸入資源名稱。格式：accounts/{account}/productInputs/{product}

data_source

string

必要欄位。應刪除產品輸入內容的主要或補充資料來源。格式：accounts/{account}/dataSources/{datasource}。

FreeShippingThreshold

產品必須符合免運費條件才能享有免運費優惠。

欄位

欄位
`country`	`string` 商品送達國家/地區的 CLDR 地域代碼。
`price_threshold`	`Price` 必須支付的最低產品價格。以數字表示。

country

string

商品送達國家/地區的 CLDR 地域代碼。

price_threshold

Price

必須支付的最低產品價格。以數字表示。

GetProductRequest

GetProduct 方法的要求訊息。

欄位

欄位
`name`	`string` 必要欄位。要擷取的產品名稱。格式：`accounts/{account}/products/{product}`

name

string

必要欄位。要擷取的產品名稱。格式：accounts/{account}/products/{product}

InsertProductInputRequest

InsertProductInput 方法的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。要插入這項產品的帳戶。格式：accounts/{account}
`product_input`	`ProductInput` 必要欄位。要插入的產品輸入內容。
`data_source`	`string` 必要欄位。主要或補充產品的資料來源名稱，如果產品已存在且提供的資料來源不同，產品就會移至新的資料來源。格式：`accounts/{account}/dataSources/{datasource}`。

parent

string

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

product_input

ProductInput

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

data_source

string

必要欄位。主要或補充產品的資料來源名稱，如果產品已存在且提供的資料來源不同，產品就會移至新的資料來源。格式：accounts/{account}/dataSources/{datasource}。

分期付款

代表分期付款的訊息。

欄位
`months`	`int64` 買家須支付的期數。
`amount`	`Price` 買家每月須支付的金額。
`downpayment`	`Price` 買家須支付的預付款項。
`credit_type`	`string` 分期付款類型。支援的值為：* "`finance`" * "`lease`"

ListProductsRequest

ListProducts 方法的要求訊息。

欄位

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

parent

string

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

page_size

int32

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

page_token

string

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

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

ListProductsResponse

ListProducts 方法的回應訊息。

欄位

欄位
`products[]`	`Product` 從指定帳戶處理過的產品。這些是在套用規則和補充資料來源後經過處理的產品。
`next_page_token`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

products[]

Product

從指定帳戶處理過的產品。這些是在套用規則和補充資料來源後經過處理的產品。

next_page_token

string

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

LoyaltyPoints

代表會員點數的訊息。

欄位

欄位
`name`	`string` 會員點數計畫的名稱。建議名稱長度不要超過 12 個全形字元或 24 個羅馬字元。
`points_value`	`int64` 零售商的會員點數絕對值。
`ratio`	`double` 點數轉換成貨幣的比率。Google 會使用 Merchant Center 設定採用幣別。如果缺少比例，預設值為 1.0。

name

string

會員點數計畫的名稱。建議名稱長度不要超過 12 個全形字元或 24 個羅馬字元。

points_value

int64

零售商的會員點數絕對值。

ratio

double

點數轉換成貨幣的比率。Google 會使用 Merchant Center 設定採用幣別。如果缺少比例，預設值為 1.0。

LoyaltyProgram

代表會員方案的訊息。

欄位
`program_label`	`string` 會員方案的標籤。這個內部標籤可用於識別商家實體和會員方案實體之間的關係。你必須提供標籤，系統才能將下列資產 (例如價格和點數) 與商家建立關聯。相應的計畫必須連結至商家帳戶。
`tier_label`	`string` 會員方案中的會員等級標籤。必須與計畫中的其中一個標籤相符。
`price`	`Price` 指定等級的會員價格，也就是即時折扣價格。必須小於或等於原價。
`cashback_for_future_use`	`Price` 日後消費時可使用的現金回饋。
`loyalty_points`	`int64` 購買交易獲得的會員點數數量。

產品

經過處理的產品，在套用規則和補充資料來源後，以多個 [產品輸入內容][[google.shopping.content.bundles.Products.ProductInput] 所建立。這項已處理的產品，與 Merchant Center 帳戶、購物廣告和其他 Google 跨平台顯示中顯示的產品相符。每項產品都是根據一項主要資料來源產品輸入內容，以及多個補充資料來源輸入內容建立而成。插入、更新或刪除產品輸入內容後，系統可能需要幾分鐘才能擷取更新後的已處理產品。

已處理產品及其子訊息中的所有欄位會與產品資料規格中相應屬性的名稱相符，但有些許例外。

欄位
`name`	`string` 產品名稱。格式：`"{product.name=accounts/{account}/products/{product}}"`
`channel`	`ChannelEnum` 僅供輸出。產品的通路。
`offer_id`	`string` 僅供輸出。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元，提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。
`content_language`	`string` 僅供輸出。以兩個字母表示產品的 ISO 639-1 語言代碼。
`feed_label`	`string` 僅供輸出。產品的動態饋給標籤。
`data_source`	`string` 僅供輸出。產品的主要資料來源。
`attributes`	`Attributes` 僅供輸出。產品屬性清單。
`custom_attributes[]`	`CustomAttribute` 僅供輸出。自訂 (商家提供) 屬性的清單。同時，您也能透過通用表單 (例如 `{ "name": "size type", "value": "regular" }`) 提交資料規格的任何屬性。提交 API 未明確公開的屬性 (例如 Buy on Google 所使用的其他屬性) 時，就相當實用。
`product_status`	`ProductStatus` 僅供輸出。產品狀態、資料驗證問題，也就是以非同步方式計算的產品相關資訊。
`version_number`	`int64` 僅供輸出。代表產品的現有版本 (新推出)，可在同時進行多項更新時保留正確的順序。如果設定，當版本號碼低於現有產品的目前版本號碼時，系統就不會插入。使用目前的`version_number`重新插入功能 (例如，30 天後更新產品)。這項功能僅支援插入主要資料來源。如果作業失敗，系統會擲回取消的例外狀況。

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"

ProductInput

這項資源代表你為產品提交的輸入資料，而非你在 Merchant Center、購物廣告或各項 Google 平台上的已處理產品。產品輸入、規則和補充資料來源資料會合併成經過處理的 [product][google.shopping.content.bundles.Products.Product]。

產品資料規格主要定義要通過資料驗證檢查的產品輸入屬性。

必要屬性包括：[feedLabel][google.shopping.content.bundles.Products.feed_label]、[contentLanguage][google.shopping.content.bundles.Products.content_language] 和 [offerId][google.shopping.content.bundles.Products.offer_id]。

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

產品輸入內容中的所有欄位及其子訊息都會符合產業規格中相應屬性的英文名稱，但部分例外狀況。

欄位
`name`	`string` ID。產品輸入的名稱。格式：`"{productinput.name=accounts/{account}/productInputs/{productinput}}"`
`product`	`string` 僅供輸出。已處理產品的名稱。格式：`"{product.name=accounts/{account}/products/{product}}"`
`channel`	`ChannelEnum` 必要欄位。不可變動。產品的通路。
`offer_id`	`string` 必要欄位。不可變動。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元，提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。
`content_language`	`string` 必要欄位。不可變動。以兩個字母表示產品的 ISO 639-1 語言代碼。
`feed_label`	`string` 必要欄位。不可變動。產品的動態饋給標籤。
`attributes`	`Attributes` 選用設定。產品屬性清單。
`custom_attributes[]`	`CustomAttribute` 選用設定。自訂 (商家提供) 屬性的清單。這個功能也可用於以一般格式 (例如 `{ "name": "size type", "value": "regular" }`) 提交資料規格的任何屬性。如要提交 API 未明確公開的屬性 (例如用於 Buy on Google 的其他屬性)，這項功能就能派上用場。每個自訂屬性的字元數上限為 10240 個 (代表名稱和值的字元總和)。每項產品最多可以設定 2500 個自訂屬性，總大小為 102.4 kB。插入自訂屬性名稱時，底線會替換成空格。
`version_number`	`int64` 選用設定。代表產品的現有版本 (新推出)，可在同時進行多項更新時保留正確的順序。如果設定，當版本號碼低於現有產品的目前版本號碼時，系統就不會插入。使用目前的`version_number`重新插入功能 (例如，30 天後更新產品)。這項功能僅支援插入主要資料來源。如果作業失敗，系統會擲回取消的例外狀況。

ProductStatus

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

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

產品狀態的目的地狀態。

欄位
`reporting_context`	`ReportingContextEnum` 報表結構定義的名稱。
`approved_countries[]`	`string` 提供優惠的國家/地區代碼 (ISO 3166-1 alpha-2)。
`pending_countries[]`	`string` 優惠尚待核准的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
`disapproved_countries[]`	`string` 拒登商品的國家/地區代碼清單 (ISO 3166-1 alpha-2)。

ItemLevelIssue

產品狀態的 ItemLevelIssue。

欄位
`code`	`string` 問題的錯誤代碼。
`severity`	`Severity` 這個問題對優惠放送的影響。
`resolution`	`string` 商家是否能解決問題。
`attribute`	`string` 屬性名稱 (如果問題是由單一屬性引起)。
`reporting_context`	`ReportingContextEnum` 問題適用的檢舉內容。
`description`	`string` 問題的簡短英文說明。
`detail`	`string` 問題的詳細英文說明。
`documentation`	`string` 協助解決問題的網頁網址。
`applicable_countries[]`	`string` 適用於優惠的國家/地區代碼清單 (ISO 3166-1 alpha-2)。

嚴重性

問題對產品放送的影響。

列舉
`SEVERITY_UNSPECIFIED`	未指定。
`NOT_IMPACTED`	這個問題代表警告，對產品不會直接影響。
`DEMOTED`	產品降低排名，且在搜尋結果中的成效可能有限
`DISAPPROVED`	問題導致產品遭到拒登。

ProductStructuredDescription

結構化說明：適用於演算法 (AI) 生成的說明。

欄位

欄位
`digital_source_type`	`string` 數位來源類型，例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。
`content`	`string` 說明文字的長度上限為 5000 個字元

digital_source_type

string

數位來源類型，例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。

content

string

說明文字的長度上限為 5000 個字元

ProductStructuredTitle

結構化標題，適用於透過演算法 (AI) 生成的標題。

欄位

欄位
`digital_source_type`	`string` 數位來源類型，例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。
`content`	`string` 標題文字長度上限為 150 個字元

digital_source_type

string

數位來源類型，例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。

content

string

標題文字長度上限為 150 個字元

ProductWeight

產品的重量。

欄位

欄位
`value`	`double` 必要欄位。以數字表示的權重。權重的最大精確度可以是四位小數。
`unit`	`string` 必要欄位。體重單位。可接受的值為：* "`g`" * "`kg`" * "`oz`" * "`lb`"

value

double

必要欄位。以數字表示的權重。權重的最大精確度可以是四位小數。

unit

string

必要欄位。體重單位。可接受的值為：* "g" * "kg" * "oz" * "lb"

運送

產品的運送資訊。

欄位
`price`	`Price` 固定運費，以數字表示。
`country`	`string` 商品送達國家/地區的 CLDR 地域代碼。
`region`	`string` 要套用運費的地理區域。詳情請參閱區域。
`service`	`string` 服務類別或運送速度的任意形式說明。
`location_id`	`int64` AdWords API 中的運費適用地點數字 ID，
`location_group_name`	`string` 適用運送服務的地點，以地區群組名稱表示。
`postal_code`	`string` 適用運費的郵遞區號範圍，以郵遞區號、郵遞區號前置字元再加上 * 萬用字元表示，範圍介於兩個郵遞區號之間，或兩個長度相同的郵遞區號前置字元。
`min_handling_time`	`int64` 從收到訂單到出貨之間的最短處理時間 (含) (以工作天計)。0 表示訂單會在截止時間之前於收到訂單的當天出貨。[minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] 只能與 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 一併出現。如果存在 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]。
`max_handling_time`	`int64` 從收到訂單到出貨之間的最長處理時間 (含) 以工作天為單位。0 表示訂單會在截止時間之前於收到訂單的當天出貨。如要提供運送速度，則必須同時提供 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 和 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]。如果有 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 有 [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] 是選填屬性。
`min_transit_time`	`int64` 從訂單出貨後到商品送達以工作天為單位的最短運送時間 (含)。0 表示訂單會在出貨當天送達。[minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] 只能與 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] 一起顯示；但如果存在 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]。
`max_transit_time`	`int64` 從訂單出貨到商品出貨所需的最長運送時間 (含) 以工作天計。0 表示訂單會在出貨當天送達。如要提供運送速度，則必須同時提供 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 和 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]。如果設有 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]，則 [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] 為選填屬性。

ShippingDimension

產品的運送尺寸。

欄位

欄位
`value`	`double` 用來計算商品運費的產品尺寸。
`unit`	`string` 值的單位。

value

double

用來計算商品運費的產品尺寸。

unit

string

值的單位。

ShippingWeight

產品的運送包裹重量。

欄位

欄位
`value`	`double` 用來計算商品運費的產品重量。
`unit`	`string` 值的單位。

value

double

用來計算商品運費的產品重量。

unit

string

值的單位。

SubscriptionCost

產品的訂閱費用。

欄位

欄位
`period`	`SubscriptionPeriod` 訂閱週期類型。支援的值為：* "`month`" * "`year`"
`period_length`	`int64` 買家須支付的訂閱週期數。
`amount`	`Price` 買家依據訂閱週期支付的金額。

period

SubscriptionPeriod

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

period_length

int64

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

amount

Price

買家依據訂閱週期支付的金額。

SubscriptionPeriod

產品的訂閱期間。

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

稅金

產品稅金。

欄位
`rate`	`double` 適用於商品價格的稅率百分比。
`country`	`string` 商品應課徵的國家/地區，以 CLDR 地域代碼的形式指定。
`region`	`string` 適用稅率的地理區域。
`tax_ship`	`bool` 如果對運費課稅，請設為 true。
`location_id`	`int64` AdWords API 中的適用稅率地區數字 ID。
`postal_code`	`string` 適用稅率的郵遞區號範圍，以郵遞區號表示，以 * 萬用字元表示郵遞區號前置碼，範圍介於兩個郵遞區號之間，或兩個長度相同的郵遞區號前置字元。範例：94114、94、94002-95460、94-95*。

UnitPricingBaseMeasure

產品的 UnitPricingBaseMeasure 產品。

欄位

欄位
`value`	`int64` 單位價格的分母。
`unit`	`string` 分母的單位。

value

int64

單位價格的分母。

unit

string

分母的單位。

UnitPricingMeasure

產品的計價單位。

欄位

欄位
`value`	`double` 商品的度量。
`unit`	`string` 測量單位。

value

double

商品的度量。

unit

string

測量單位。