Package google.shopping.merchant.products.v1beta

string

商品圖片的其他網址。

Timestamp

商品到期的日期 (於插播時指定)，採用 ISO 8601 格式。實際到期日會在 productstatuses 中顯示為 googleExpirationDate，如果 expirationDate 設在太久的未來，實際到期日可能會提早。

Timestamp

產品出現在 Google 的 YouTube 平台上搜尋結果中的日期時間，採用 ISO 8601 格式。詳情請參閱「[揭露日期]( https://support.google.com/merchants/answer/13034208)」。

Timestamp

預購產品可出貨的日期，格式為 ISO 8601。

string

商品的全球交易品項識別碼 (GTIN)。最多可提供 10 個 GTIN。

Price

商品價格。

Installment

購買商品時的期數和金額。

SubscriptionCost

項目 (含相關訂閱合約) 的期數 (以月或年為單位) 和每期付款金額。

LoyaltyPoints

使用者購買商品後獲得的會員點數。僅限日本。

LoyaltyProgram

會員方案資訊清單，用於向使用者顯示會員福利 (例如更優惠的價格、點數等)。

string

商品類別 (格式請參閱產品資料規格)。

Price

商品的廣告特價。

Interval

商品的特價期間 (請參閱產品資料規格)。

ProductDimension

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

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

運送規則。

FreeShippingThreshold

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

ShippingWeight

運送商品的重量。

ShippingDimension

運送商品的長度。

ShippingDimension

運送包裹的寬度。

ShippingDimension

運送商品的高度。

string

商品的裁剪方式。可用來代表服飾商品的組合尺寸類型。最多可提供兩種尺寸類型 (請參閱 [https://support.google.com/merchants/answer/6324497](尺寸類型))。

Tax

稅務資訊。

UnitPricingMeasure

項目的測量單位和尺寸。

UnitPricingBaseMeasure

單位價格分母的偏好設定。

string

與 ads_grouping 類似，但只適用於單次點擊出價。

Price

銷貨成本。用於毛利報表。

ProductDetail

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

string

產品最相關的亮點，以項目符號表示。

string

廣告主指定的建議值。

string

促銷活動的專屬 ID。

string

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

string

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

string

排除購物廣告目的地的商品時，要使用的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。這份清單中的國家/地區會從資料來源設定中移除。

string

商品生活模擬照的其他網址，用於明確指出在真實環境中展示商品的圖片。詳情請參閱這篇說明中心文章。

CloudExportAdditionalProperties

要匯出至 Cloud Retail 計畫的額外欄位。

Certification

產品認證，例如在 歐盟 EPREL 資料庫中記錄的產品能源效率標章。詳情請參閱說明中心文章。

Price

「自動折扣」(https://support.google.com/merchants/answer/10295759) 和「動態促銷」(https://support.google.com/merchants/answer/13949249) 專案中的安全防護機制，可確保商家商品的折扣不會低於這個值，進而維持商品的價值和獲利能力。

ProductSustainabilityIncentive

永續發展獎勵計畫清單。

bool

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

bool

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

string

項目名稱。

string

項目說明。

string

直接連結至網路商店商品頁面的網址。

string

商品行動裝置專用到達網頁的網址。

string

項目到達網頁標準版本的網址。

string

商品圖片的網址。

bool

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

string

商品的目標年齡層。

string

商品的供應情形狀態。

string

商品品牌。

string

商品的顏色。

string

商品的狀況或狀態。

string

商品的目標客群性別。

string

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

string

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

string

商品製造原料。

string

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

string

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

int64

可在 Google 上販售的產品數量。僅適用於線上產品。

int64

產品處理時間上限 (以工作天為單位)。

int64

產品處理時間最短 (以工作天計)。

string

產品的運送標籤，用於在帳戶層級運送規則中將產品分組。

string

產品的運送時間標籤，用於在帳戶層級運送時間表中將產品分組。

string

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

string

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

string

產品的稅務類別。

string

歐盟指令 2010/30/EU 中定義的能源效率等級。

string

歐盟指令 2010/30/EU 中定義的能源效率等級。

string

歐盟指令 2010/30/EU 中定義的能源效率等級。

int64

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

string

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

string

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

string

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

string

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

string

直接連往動態再行銷廣告活動項目的到達網頁網址。

double

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

string

商品的取貨選項。

string

商品的到店取貨時程。

string

商家代管的本地店面連結範本。

string

針對行動裝置最佳化的商家代管本地店面連結範本。

string

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

string

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

string

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

string

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

string

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

string

對於多重賣方帳戶，這是必填屬性。如果你是市集管理員，會將不同賣方的產品上傳至多重賣方帳戶，請使用這項屬性。

string

這項商品的發布作業會暫時暫停。

string

商品的 3D 圖片網址。詳情請參閱這篇說明中心文章。

ProductStructuredTitle

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

ProductStructuredDescription

結構化說明，用於透過演算法 (AI) 產生的說明。

string

發證機構，例如「European_Commission」。長度上限為 2000 個半形字元。

string

證照名稱，例如「EPREL」。長度上限為 2000 個半形字元。

string

認證號碼。長度上限為 2000 個半形字元。

string

認證值 (也稱為等級或等級)，例如「A+」、「C」、「金牌」。長度上限為 2000 個半形字元。

string

指定屬性的文字值。舉例來說，「8K(UHD)」可能是電視產品的文字值。這個值的最大重複次數為 400。值會以任意但一致的順序儲存。字串長度上限為 256 個半形字元。

int64

指定屬性的整數值。舉例來說，電視產品的螢幕解析度為 1080。這個值的最大重複次數為 400。值會以任意但一致的順序儲存。

float

指定屬性的浮點值。舉例來說，如果是電視產品 1.2345，這個值的最大重複次數為 400。值會以任意但一致的順序儲存。

string

指定屬性的名稱。例如，電視產品的「螢幕解析度」。字串長度上限為 256 個半形字元。

bool

指定屬性的布林值。舉例來說，如果電視產品的螢幕為 UHD，則輸入「True」或「False」。

float

指定屬性的最小浮點值。例如電視產品 1.00。

float

指定屬性的最大浮點值。例如電視產品 100.00。

string

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

string

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

string

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

string

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

Price

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

string

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

string

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

ProductInput

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

string

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

僅支援 API 資料來源。

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

int64

買家須支付的期數。

Price

買家每月須支付的金額。

Price

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

string

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

string

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

int32

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

string

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

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

Product

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

string

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

string

會員點數計畫名稱。建議您將名稱限制在 12 個全形字元或 24 個半形字元以內。

int64

零售商的忠誠度積分絕對值。

double

點數轉換成貨幣的比率。Google 會根據 Merchant Center 設定假設幣別。如果省略比率，系統會預設為 1.0。

string

會員方案的標籤。這是內部標籤，可用來識別商家實體和會員方案實體之間的關係。請務必提供標籤，讓系統將下列資產 (例如價格和點數) 與商家建立關聯。對應的方案必須連結至商家帳戶。

string

會員方案等級的標籤。必須與計畫中的其中一個標籤相符。

Price

特定級別會員的價格，也就是即時折扣價。必須小於或等於一般價格。

Price

可用於日後消費的現金回饋。

int64

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

Interval

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

string

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

string

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

ChannelEnum

僅供輸出。產品的通路。

string

僅供輸出。產品的專屬 ID。產品輸入內容和經過處理的產品皆是如此。系統會移除開頭和結尾的空白字元，並在提交時將多個空白字元替換為單一空白字元。詳情請參閱產品資料規格。

string

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

string

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

string

僅供輸出。產品的主要資料來源。

Attributes

僅供輸出。產品屬性清單。

CustomAttribute

僅供輸出。自訂 (商家提供) 屬性清單。也可以用來以通用格式 (例如 { "name": "size type", "value": "regular" }) 提交資料規格中的任何屬性。這對於提交 API 未明確公開的屬性 (例如用於 Buy on Google 的額外屬性) 很有幫助。

ProductStatus

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

int64

僅供輸出。代表產品的現有版本 (新鮮度)，可用於在同時進行多項更新時，保留正確的順序。

如果已設定，當版本編號低於現有產品的目前版本編號時，就會防止插入。您可以使用目前的 version_number 執行重新插入作業 (例如在 30 天後重新發布產品)。

僅支援插入主要資料來源。

如果作業遭到阻止，系統會擲回中止例外狀況。

string

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

string

產品詳細資料的名稱。

string

產品詳細資料的值。

double

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

string

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

string

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

string

僅供輸出。經處理的產品名稱。格式："{product.name=accounts/{account}/products/{product}}"

ChannelEnum

不可變動。產品的通路。

string

必要欄位。不可變動。產品的專屬 ID。產品輸入內容和經過處理的產品皆是如此。系統會移除開頭和結尾的空白字元，並在提交時將多個空白字元替換為單一空白字元。詳情請參閱產品資料規格。

string

必要欄位。不可變動。產品的雙字母 ISO 639-1 語言代碼。

string

必要欄位。不可變動。產品的動態饋給標籤。

Attributes

選用設定。產品屬性清單。

CustomAttribute

選用設定。自訂 (商家提供) 屬性清單。也可以用來以通用格式 (例如 { "name": "size type", "value": "regular" }) 提交資料規格中的任何屬性。這對於提交 API 未明確公開的屬性 (例如用於 Buy on Google 的額外屬性) 很有幫助。每個自訂屬性允許的字元數上限為 10240 個 (代表名稱和值的字元總數)。每項產品最多可設定 2500 個自訂屬性，總大小為 102.4 KB。插入時，自訂屬性名稱中的底線會替換為空格。

int64

選用設定。代表產品的現有版本 (新鮮度)，可用於在同時進行多項更新時，保留正確的順序。

如果已設定，當版本編號低於現有產品的目前版本編號時，就會防止插入。您可以使用目前的 version_number 執行重新插入作業 (例如在 30 天後重新發布產品)。

僅支援插入主要資料來源。

如果作業遭到阻止，系統會擲回中止例外狀況。

DestinationStatus

產品的預定目的地。

ItemLevelIssue

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

Timestamp

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

Timestamp

項目上次更新的日期，採用 ISO 8601 格式。

Timestamp

項目到期日，採用 ISO 8601 格式。

ReportingContextEnum

報表內容名稱。

string

已核准商品的國家/地區代碼清單 (ISO 3166-1 alpha-2)。

string

待核准商品適用的國家/地區代碼 (ISO 3166-1 alpha-2) 清單。

string

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

string

問題的錯誤代碼。

Severity

這個問題對優惠提供的影響程度。

string

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

string

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

ReportingContextEnum

問題適用的回報情境。

string

問題的簡短英文說明。

string

問題的詳細英文說明。

string

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

string

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

string

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

string

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

string

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

string

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

Price

獎勵的固定金額。

double

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

Type

永續發展獎勵計畫。

double

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

string

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

Price

固定運費，以數字表示。

string

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

string

要套用運費的地理區域。詳情請參閱「地區」一節。

string

服務類別或運送時間的說明 (格式不限)。

int64

根據 AdWords API 中的定義套用運費的地區所對應的數字 ID。

string

適用運送服務的地區，以地區群組名稱表示。

string

要套用運費的郵遞區號範圍，以郵遞區號、郵遞區號前置碼加上萬用字元 *、由兩組郵遞區號組成的範圍，或是由兩組長度相同的郵遞區號前置碼組成的範圍表示。

int64

從收到訂單到出貨之間的最短處理時間 (含處理時間)，以工作天為單位。0 表示訂單會在收到訂單當天出貨 (如果訂單是在截止時間前收到)。minHandlingTime 只能與 maxHandlingTime 一同出現；但如果 maxHandlingTime 已存在，則不必使用 minHandlingTime。

int64

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

int64

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

int64

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

double

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

string

值的單位。

double

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

string

值的單位。

SubscriptionPeriod

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

int64

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

Price

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

double

適用於商品價格的稅率百分比。

string

向商品課稅的國家/地區，以 CLDR 地區編碼指定。

string

應適用特定稅率的地理區域。

bool

如果運費需要收取稅金，請將此值設為 true。

int64

根據 AdWords API 中的定義採用特定稅率的地區所對應的 ID 數字。

string

要套用稅率的郵遞區號範圍，以郵遞區號、加上萬用字元 (*) 的郵遞區號前置碼範圍、由兩組郵遞區號組成的範圍，或是由兩組長度相同的郵遞區號前置碼組成的範圍表示。例如 94114、94*、94002-95460、94*-95*。

int64

單位價格的分母。

string

分母的單位。

double

項目的測量單位。

string

測量單位。