Package google.shopping.merchant.products.v1beta

索引

ProductInputsService

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

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。

ProductsService

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

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。

屬性

屬性。

欄位
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。
gtin[]

string

商品的全球交易品項識別碼 (GTIN)。最多可提供 10 個 GTIN。
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 (含) 之間。
product_length

ProductDimension

產品長度 (以提供的單位表示)。這個值必須介於 0 (不含) 和 3000 (含) 之間。
product_width

ProductDimension

產品的寬度，以提供的單位表示。這個值必須介於 0 (不含) 和 3000 (含) 之間。
product_weight

ProductWeight

產品的重量，以提供的單位表示。值必須介於 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) 清單。這份清單中的國家/地區會從資料來源設定中移除。
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) 專案中的安全防護機制，可確保商家商品的折扣不會低於這個值，進而維持商品的價值和獲利能力。
sustainability_incentives[]

ProductSustainabilityIncentive

永續發展獎勵計畫清單。
identifier_exists

bool

如果商品沒有與其類別相符的專屬產品 ID (例如全球交易品項識別碼、製造商零件編號和品牌)，請將這個值設為 false。如果未提供，預設值為 true。
is_bundle

bool

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

string

項目名稱。
description

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 產品類別。
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

用於任意分組項目。僅適用於 CPA%，不建議用於其他出價。
ads_redirect

string

當產品顯示在產品廣告的內容中時，廣告客戶可以覆寫商品網址。
display_ads_id

string

動態再行銷廣告活動項目的識別碼。
display_ads_title

string

動態再行銷廣告活動項目的名稱。
display_ads_value

double

動態再行銷廣告活動的利潤。
pickup_method

string

商品的取貨選項。
pickup_sla

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

這項商品的發布作業會暫時暫停。
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 的產品屬性。舉例來說，電視產品的屬性可能是「Screen-Resolution」或「Screen-Size」。

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

指定屬性的單位。例如電視產品的「像素」。字串大小上限為 256 B。

DeleteProductInputRequest

DeleteProductInput 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的產品輸入資源名稱。格式：accounts/{account}/productInputs/{product}，其中最後一個部分 product 包含 4 個部分：channel~content_language~feed_label~offer_id。產品名稱的範例為「accounts/123/productInputs/online~en~US~sku123」。
data_source

string

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

FreeShippingThreshold

產品必須符合哪些條件，才能享有免運費服務。

欄位
country

string

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

Price

達到免運費門檻的最低產品價格。以數字表示。

GetProductRequest

GetProduct 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的產品名稱。格式：accounts/{account}/products/{product}，其中最後一節 product 包含 4 個部分：channel~content_language~feed_label~offer_id。產品名稱的範例為「accounts/123/products/online~en~US~sku123」。

InsertProductInputRequest

InsertProductInput 方法的要求訊息。

欄位
parent

string

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

ProductInput

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

string

必要欄位。主要或補充產品資料來源名稱。如果產品已存在，且提供的資料來源不同，系統會將產品移至新的資料來源。

僅支援 API 資料來源。

格式：accounts/{account}/dataSources/{datasource}。

分期付款

代表分期付款的訊息。

欄位
months

int64

買家須支付的期數。
amount

Price

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

Price

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

string

分期付款類型。支援的值如下： * "finance" * "lease"

列出產品要求

ListProducts 方法的要求訊息。

欄位
parent

string

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

int32

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

string

從先前 ListProducts 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

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

列出產品回應

ListProducts 方法的回應訊息。

欄位
products[]

Product

指定帳戶中已處理的產品。這些是套用規則和補充資料來源後的處理產品。
next_page_token

string

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

LoyaltyPoints

代表會員點數的訊息。

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

購買交易獲得的會員點數。
member_price_effective_date

Interval

商品適用會員價的日期範圍。如果未指定，系統一律會套用會員價格。日期範圍由一組 ISO 8601 日期表示，並以空格、半形逗號或斜線分隔。
shipping_label

string

運送福利的標籤。如果欄位有值，則這項商品含有會員運送福利。如果未提供欄位值，則該商品不符合指定會員等級的會員運送資格。

產品

處理後的產品，在套用規則和補充資料來源後，由多個 product inputs 建構而成。這個經過處理的產品會與 Merchant Center 帳戶、購物廣告和 Google 跨平台顯示的產品資訊相符。每個產品都會使用單一主要資料來源產品輸入內容和多個補充資料來源輸入內容建立。插入、更新或刪除產品輸入內容後，可能需要幾分鐘的時間才能擷取更新後的處理產品。

經處理的產品及其子訊息中的所有欄位，都與產品資料規格中相應屬性的名稱相符 (但有部分例外狀況)。

欄位
name

string

產品名稱。格式："{product.name=accounts/{account}/products/{product}}"，其中最後一節 product 包含 4 個部分：channel~content_language~feed_label~offer_id。產品名稱的範例為「accounts/123/products/online~en~US~sku123」。
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

產品詳細資料的值。

ProductDimension

產品的尺寸。

欄位
value

double

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

string

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

ProductInput

這個資源代表你為產品提交的輸入資料，而非你在 Merchant Center、購物廣告或 Google 跨平台顯示中看到的已處理產品。產品輸入內容、規則和補充資料來源資料會合併，以建立經過處理的 Product。

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

以下屬性為必填：feedLabel、contentLanguage 和 offerId。

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

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

欄位
name

string

ID。產品輸入內容的名稱。格式："{productinput.name=accounts/{account}/productInputs/{productinput}}"，其中最後一節 productinput 包含 4 個部分：channel~content_language~feed_label~offer_id。產品輸入名稱的範例為「accounts/123/productInputs/online~en~US~sku123」。
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

數位來源類型，例如「trained_algorithmic_media」。遵循 IPTC 標準。長度上限為 40 個半形字元。
content

string

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

ProductStructuredTitle

結構化名稱，用於演算法 (AI) 產生的名稱。

欄位
digital_source_type

string

數位來源類型，例如「trained_algorithmic_media」。遵循 IPTC 標準。長度上限為 40 個半形字元。
content

string

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

ProductSustainabilityIncentive

與永續發展相關的獎勵計畫資訊，例如折扣或稅務減免。

欄位
聯集欄位 value。永續發展獎勵價值。value 只能是下列其中一項：
amount

Price

獎勵的固定金額。
percentage

double

獎勵適用於特價的百分比。
type

Type

永續發展獎勵計畫。

類型

支援的永續發展獎勵計畫類型。

列舉
TYPE_UNSPECIFIED 未指定或不明的永續發展獎勵類型。
EV_TAX_CREDIT 這項計畫針對電動汽車和部分國家/地區的插電式油電混合車提供稅務減免。這些折扣可以是特定金額，或是銷售價格的百分比。
EV_PRICE_DISCOUNT 補助計畫 (通常稱為環保獎勵) 會為電動車提供購車補助，在部分國家/地區則會為插電式油電混合車提供補助。補助金額可以是固定金額，也可以是銷售價格的百分比。

ProductWeight

產品重量。

欄位
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 只能與 maxHandlingTime 一同出現；但如果 maxHandlingTime 已存在，則不必使用 minHandlingTime。
max_handling_time

int64

從收到訂單到出貨之間 (含) 最長處理時間 (以工作天為單位)。0 表示訂單會在收到訂單當天出貨 (如果訂單是在截止時間前收到)。如要提供運送速度，必須同時提供 maxHandlingTime 和 maxTransitTime。如果 maxHandlingTime 存在，minHandlingTime 為選用欄位。
min_transit_time

int64

從訂單出貨到送達之間 (含) 最短運送時間 (以工作天為單位)。0 代表訂單會在出貨當天送達。minTransitTime 只能與 maxTransitTime 一同出現；但如果 maxTransitTime 已存在，則不必使用 minTransitTime。
max_transit_time

int64

從訂單出貨到送達之間 (含) 的最長運送時間 (以工作天計算)。0 代表訂單會在出貨當天送達。如要提供運送速度，必須同時提供 maxHandlingTime 和 maxTransitTime。如果 maxTransitTime 存在，minTransitTime 為選用欄位。

ShippingDimension

產品的 ShippingDimension。

欄位
value

double

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

string

值的單位。

ShippingWeight

產品的運送包裹重量。

欄位
value

double

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

string

值的單位。

SubscriptionCost

產品的 SubscriptionCost。

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

分母的單位。

UnitPricingMeasure

產品的 UnitPricingMeasure。

欄位
value

double

項目的測量單位。
unit

string

測量單位。