- 資源:產品
- 屬性
- 分期付款
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- 運送
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- 稅金
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- 認證
- ProductStructuredTitle
- ProductStructuredDescription
- ProductStatus
- DestinationStatus
- ItemLevelIssue
- 嚴重性
- 方法
資源:產品
經過處理的產品,在套用規則和補充資料來源後,以多個 [產品輸入內容][[google.shopping.content.bundles.Products.ProductInput] 所建立。這項已處理的產品,與 Merchant Center 帳戶、購物廣告和其他 Google 跨平台顯示中顯示的產品相符。每項產品都是根據一項主要資料來源產品輸入內容,以及多個補充資料來源輸入內容建立而成。插入、更新或刪除產品輸入內容後,系統可能需要幾分鐘才能擷取更新後的已處理產品。
已處理產品及其子訊息中的所有欄位會與產品資料規格中相應屬性的名稱相符,但有些許例外。
JSON 表示法 |
---|
{ "name": string, "channel": enum ( |
欄位 | |
---|---|
name |
產品名稱。格式: |
channel |
僅供輸出。產品的通路。 |
offerId |
僅供輸出。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元,提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。 |
contentLanguage |
僅供輸出。以兩個字母表示產品的 ISO 639-1 語言代碼。 |
feedLabel |
僅供輸出。產品的動態饋給標籤。 |
dataSource |
僅供輸出。產品的主要資料來源。 |
attributes |
僅供輸出。產品屬性清單。 |
customAttributes[] |
僅供輸出。自訂 (商家提供) 屬性的清單。同時,您也能透過通用表單 (例如 |
productStatus |
僅供輸出。產品狀態、資料驗證問題,也就是以非同步方式計算的產品相關資訊。 |
versionNumber |
僅供輸出。代表產品的現有版本 (新推出),可在同時進行多項更新時保留正確的順序。 如果設定,當版本號碼低於現有產品的目前版本號碼時,系統就不會插入。使用目前的 這項功能僅支援插入主要資料來源。 如果作業失敗,系統會擲回取消的例外狀況。 |
屬性
屬性。
JSON 表示法 |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "price": { object ( |
欄位 | |
---|---|
additionalImageLinks[] |
項目圖片的其他網址。 |
expirationDate |
商品的到期日 (在插入時指定,採用 ISO 8601 格式)。實際到期日會在 |
disclosureDate |
商品在 Google 各項 YouTube 平台搜尋結果中顯示的日期時間 (採用 ISO 8601 格式)。詳情請參閱 [揭露日期]( https://support.google.com/merchants/answer/13034208)。 |
availabilityDate |
預購產品可出貨的日期 (採用 ISO 8601 格式)。 |
price |
商品的價格。 |
installment |
為單一商品支付的分期付款金額和金額。 |
subscriptionCost |
相關訂閱合約的每期付款週期數 (單位為月或年) 與付款金額。 |
loyaltyPoints |
使用者購買商品後獲得的會員點數。僅限日本。 |
loyaltyPrograms[] |
會員方案資訊,用來向商品的使用者顯示會員福利,例如更優惠的價格、點數等。 |
productTypes[] |
商品類別 (格式為產品資料規格)。 |
salePrice |
商品的廣告特價。 |
salePriceEffectiveDate |
商品特價的日期範圍 (請參閱產品資料規格)。 |
productHeight |
產品高度,以提供的單位表示。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。 |
productLength |
產品長度 (以提供的單位表示)。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。 |
productWidth |
產品寬度,以提供的單位表示。這個值必須介於 0 至 3000 之間 (不含 0 和 3000)。 |
productWeight |
以單位提供的產品重量表示產品重量。這個值必須介於 0 至 2000 之間 (不含 0 和 2000)。 |
shipping[] |
運送規則。 |
freeShippingThreshold[] |
產品必須符合免運費條件才能享有免運費優惠。 |
shippingWeight |
商品運送包裹重量。 |
shippingLength |
運送項目的長度。 |
shippingWidth |
運送項目的寬度。 |
shippingHeight |
運送商品的高度。 |
sizeTypes[] |
項目剪裁。此屬性可用於表示服飾商品的綜合尺寸類型。最多可以提供兩種尺寸類型 (請參閱 [https://support.google.com/merchants/answer/6324497](尺寸類型))。 |
taxes[] |
稅務資訊。 |
unitPricingMeasure |
商品的度量和尺寸。 |
unitPricingBaseMeasure |
單位價格的分母。 |
adsLabels[] |
與 adsGrouping 類似,但只適用於單次點擊出價。 |
costOfGoodsSold |
銷貨成本。用於回報毛利。 |
productDetails[] |
技術規格或其他產品詳細資料。 |
productHighlights[] |
用條列式說明產品最相關的亮點。 |
displayAdsSimilarIds[] |
廣告主指定的建議。 |
promotionIds[] |
促銷活動的專屬 ID。 |
includedDestinations[] |
要為這個目標加入的目的地清單 (對應 Merchant Center 中勾選的核取方塊)。除非 |
excludedDestinations[] |
要為這個目標排除的目的地清單 (對應 Merchant Center 中取消勾選的核取方塊)。 |
shoppingAdsExcludedCountries[] |
要從購物廣告到達網頁中排除的商品國家/地區代碼清單 (ISO 3166-1 alpha-2)。系統會從資料來源設定中所設的國家/地區移除這份清單中的國家/地區。 |
lifestyleImageLinks[] |
商品生活風格圖片的其他網址,用來明確識別在實際環境中呈現您商品的圖片。詳情請參閱說明中心文章。 |
cloudExportAdditionalProperties[] |
要匯出至 Cloud Retail 計畫的額外欄位。 |
certifications[] |
|
autoPricingMinPrice |
「自動折扣」(https://support.google.com/merchants/answer/10295759) 和「動態促銷活動」(https://support.google.com/merchants/answer/13949249) 專案中的保護措施,確保商家優惠的折扣不會低於這個值,進而保障優惠價值和獲利能力。 |
identifierExists |
如果商品沒有符合所屬類別的專屬產品 ID (例如全球交易品項識別碼、製造商零件編號和品牌),請將這個值設為 false。如未提供,預設為 true。 |
isBundle |
商品是否為商家定義的套裝組合。套裝組合是指商家以單一價格販售的各種不同產品的自訂分組。 |
title |
項目的名稱。 |
description |
商品說明。 |
link |
直接連結至網路商店中商品頁面的網址。 |
mobileLink |
針對行動裝置最佳化的商品到達網頁版本網址。 |
canonicalLink |
商品到達網頁的標準版本網址。 |
imageLink |
商品圖片的網址。 |
adult |
如果該項目是以成人為目標對象,則設為 true。 |
ageGroup |
商品的指定年齡層。 |
availability |
商品的供應情形狀態。 |
brand |
商品的品牌。 |
color |
項目顏色。 |
condition |
商品的狀況或狀態。 |
gender |
項目的目標性別。 |
googleProductCategory |
商品的 Google 類別 (請參閱 Google 產品分類)。查詢產品時,這個欄位會包含使用者提供的值。目前無法透過 API 取回系統自動指派的 Google 產品類別。 |
gtin |
商品的全球交易品項識別碼 (GTIN)。 |
itemGroupId |
同一產品所有子類的共用 ID。 |
material |
物品的材質。 |
mpn |
商品的製造商零件編號 (MPN)。 |
pattern |
項目的圖案 (例如波卡圓點)。 |
sellOnGoogleQuantity |
在 Google 上販售的產品數量。僅適用於線上產品。 |
maxHandlingTime |
產品處理時間最長 (以工作天計)。 |
minHandlingTime |
最短的產品處理時間 (以工作天計)。 |
shippingLabel |
產品的運送標籤,用於在帳戶層級運送規則中將產品分類。 |
transitTimeLabel |
產品的運送時間標籤,用於在帳戶層級的運送時間表格中將產品分組。 |
size |
商品尺寸。只能輸入一個值。如果是具有不同尺寸的子類,請為每個尺寸插入不同的產品,並加入相同的 |
sizeSystem |
指定大小的系統。建議用於服飾商品。 |
taxCategory |
產品的稅目,用於在帳戶層級的稅金設定中設置詳細的稅務課稅關聯。 |
energyEfficiencyClass |
歐盟指令 2010/30/EU 中定義的能源效率等級。 |
minEnergyEfficiencyClass |
歐盟指令 2010/30/EU 中定義的能源效率等級。 |
maxEnergyEfficiencyClass |
歐盟指令 2010/30/EU 中定義的能源效率等級。 |
multipack |
同一款產品在商家定義組合包中的數量。 |
adsGrouping |
可使用任意方式將項目分組,僅適用於單次轉換百分比,否則不建議使用。 |
adsRedirect |
允許廣告主在產品廣告顯示時覆寫商品網址。 |
displayAdsId |
動態再行銷廣告活動項目的 ID。 |
displayAdsTitle |
動態再行銷廣告活動項目的名稱。 |
displayAdsLink |
直接連往動態再行銷廣告活動項目的到達網頁網址。 |
displayAdsValue |
提供動態再行銷廣告活動利潤。 |
pickupMethod |
商品的取貨選項。 |
pickupSla |
商品的到店取貨時間。 |
linkTemplate |
商家代管的本地店面連結範本。 |
mobileLinkTemplate |
針對行動裝置最佳化的商家代管的本地店面連結範本。 |
customLabel0 |
購物廣告活動中商品自訂分組的自訂標籤 0。 |
customLabel1 |
用於購物廣告活動中的商品自訂分組的自訂標籤 1。 |
customLabel2 |
用於購物廣告活動中的商品自訂分組的自訂標籤 2。 |
customLabel3 |
用於購物廣告活動中的商品自訂分組自訂標籤 3。 |
customLabel4 |
用於購物廣告活動中的商品自訂分組的自訂標籤 4。 |
externalSellerId |
以多重賣方帳戶來說,此為必填屬性。如果您是會將不同賣家的產品上傳至多重賣家帳戶的市集,請使用這項屬性。 |
pause |
系統會暫時暫停發布這個項目。 |
virtualModelLink |
商品的 3D 圖片網址。詳情請參閱說明中心文章。 |
structuredTitle |
結構化標題,適用於透過演算法 (AI) 生成的標題。 |
structuredDescription |
結構化說明:適用於演算法 (AI) 生成的說明。 |
分期付款
代表分期付款的訊息。
JSON 表示法 |
---|
{ "months": string, "amount": { object ( |
欄位 | |
---|---|
months |
買家須支付的期數。 |
amount |
買家每月須支付的金額。 |
downpayment |
買家須支付的預付款項。 |
creditType |
分期付款類型。支援的值為:* " |
SubscriptionCost
產品的訂閱費用。
JSON 表示法 |
---|
{ "period": enum ( |
欄位 | |
---|---|
period |
訂閱週期類型。支援的值為:* " |
periodLength |
買家須支付的訂閱週期數。 |
amount |
買家依據訂閱週期支付的金額。 |
SubscriptionPeriod
產品的訂閱期間。
列舉 | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
表示未指定訂閱期間。 |
MONTH |
表示訂閱期為月。 |
YEAR |
表示訂閱期為年。 |
LoyaltyPoints
代表會員點數的訊息。
JSON 表示法 |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
欄位 | |
---|---|
name |
會員點數計畫的名稱。建議名稱長度不要超過 12 個全形字元或 24 個羅馬字元。 |
pointsValue |
零售商的會員點數絕對值。 |
ratio |
點數轉換成貨幣的比率。Google 會使用 Merchant Center 設定採用幣別。如果缺少比例,預設值為 1.0。 |
LoyaltyProgram
代表會員方案的訊息。
JSON 表示法 |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
欄位 | |
---|---|
programLabel |
會員方案的標籤。這個內部標籤可用於識別商家實體和會員方案實體之間的關係。你必須提供標籤,系統才能將下列資產 (例如價格和點數) 與商家建立關聯。相應的計畫必須連結至商家帳戶。 |
tierLabel |
會員方案中的會員等級標籤。必須與計畫中的其中一個標籤相符。 |
price |
指定等級的會員價格,也就是即時折扣價格。必須小於或等於原價。 |
cashbackForFutureUse |
日後消費時可使用的現金回饋。 |
loyaltyPoints |
購買交易獲得的會員點數數量。 |
ProductDimension
產品的尺寸。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
欄位 | |
---|---|
value |
必要欄位。以數字表示的維度值。此值的精確度最高可達四位數。 |
unit |
必要欄位。尺寸單位。可接受的值為:* " |
ProductWeight
產品的重量。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
欄位 | |
---|---|
value |
必要欄位。以數字表示的權重。權重的最大精確度可以是四位小數。 |
unit |
必要欄位。體重單位。可接受的值為:* " |
運送
產品的運送資訊。
JSON 表示法 |
---|
{
"price": {
object ( |
欄位 | |
---|---|
price |
固定運費,以數字表示。 |
country |
商品送達國家/地區的 CLDR 地域代碼。 |
region |
要套用運費的地理區域。詳情請參閱區域。 |
service |
服務類別或運送速度的任意形式說明。 |
locationId |
AdWords API 中的運費適用地點數字 ID, |
locationGroupName |
適用運送服務的地點,以地區群組名稱表示。 |
postalCode |
適用運費的郵遞區號範圍,以郵遞區號、郵遞區號前置字元再加上 * 萬用字元表示,範圍介於兩個郵遞區號之間,或兩個長度相同的郵遞區號前置字元。 |
minHandlingTime |
從收到訂單到出貨之間的最短處理時間 (含) (以工作天計)。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]。 |
maxHandlingTime |
從收到訂單到出貨之間的最長處理時間 (含) 以工作天為單位。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] 是選填屬性。 |
minTransitTime |
從訂單出貨後到商品送達以工作天為單位的最短運送時間 (含)。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]。 |
maxTransitTime |
從訂單出貨到商品出貨所需的最長運送時間 (含) 以工作天計。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] 為選填屬性。 |
FreeShippingThreshold
產品必須符合免運費條件才能享有免運費優惠。
JSON 表示法 |
---|
{
"country": string,
"priceThreshold": {
object ( |
欄位 | |
---|---|
country |
商品送達國家/地區的 CLDR 地域代碼。 |
priceThreshold |
必須支付的最低產品價格。以數字表示。 |
ShippingWeight
產品的運送包裹重量。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
欄位 | |
---|---|
value |
用來計算商品運費的產品重量。 |
unit |
值的單位。 |
ShippingDimension
產品的運送尺寸。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
欄位 | |
---|---|
value |
用來計算商品運費的產品尺寸。 |
unit |
值的單位。 |
稅金
產品稅金。
JSON 表示法 |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
欄位 | |
---|---|
rate |
適用於商品價格的稅率百分比。 |
country |
商品應課徵的國家/地區,以 CLDR 地域代碼的形式指定。 |
region |
適用稅率的地理區域。 |
taxShip |
如果對運費課稅,請設為 true。 |
locationId |
AdWords API 中的適用稅率地區數字 ID。 |
postalCode |
適用稅率的郵遞區號範圍,以郵遞區號表示,以 * 萬用字元表示郵遞區號前置碼,範圍介於兩個郵遞區號之間,或兩個長度相同的郵遞區號前置字元。範例:94114、94*、94002-95460、94*-95*。 |
UnitPricingMeasure
產品的計價單位。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
欄位 | |
---|---|
value |
商品的度量。 |
unit |
測量單位。 |
UnitPricingBaseMeasure
產品的 UnitPricingBaseMeasure 產品。
JSON 表示法 |
---|
{ "value": string, "unit": string } |
欄位 | |
---|---|
value |
單位價格的分母。 |
unit |
分母的單位。 |
ProductDetail
產品詳細資料。
JSON 表示法 |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
欄位 | |
---|---|
sectionName |
這個部分標題可用於將一組產品詳細資料分組。 |
attributeName |
產品詳細資料的名稱。 |
attributeValue |
產品詳細資料的值。 |
CloudExportAdditionalProperties
Cloud Retail API 的產品屬性。舉例來說,電視產品的屬性可以是「螢幕解析度」或「螢幕尺寸」。
JSON 表示法 |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
欄位 | |
---|---|
textValue[] |
指定屬性的文字值。舉例來說,「8K(UHD)」可以是電視產品的文字值。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存,字串大小上限為 256 個字元。 |
intValue[] |
指定屬性的整數值。例如,電視產品的螢幕解析度為 1080。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存, |
floatValue[] |
指定屬性的浮點值。以電視產品 1.2345 為例。這個值的重複次數上限為 400。資料會以任意但一致的順序儲存, |
propertyName |
指定屬性的名稱。例如電視產品的「螢幕解析度」。字串大小上限為 256 個字元。 |
boolValue |
指定屬性的布林值。舉例來說,如果是電視產品,螢幕為 UHD 時,請設為「True」或「False」。 |
minValue |
指定屬性的最小浮點數值。以電視產品 1.00 為例。 |
maxValue |
指定屬性的浮點值上限。例如電視產品 100.00。 |
unitCode |
指定屬性的單位。舉例來說,如果電視產品是「像素」,字串大小上限為 256B。 |
認證
產品認證,最初是依據歐盟 EPREL 資料庫遵循歐盟能源效率標籤法規而推出。
JSON 表示法 |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
欄位 | |
---|---|
certificationAuthority |
發證機構,例如「European_Commission」。長度上限為 2000 個半形字元。 |
certificationName |
證照的名稱,例如「EPREL」。長度上限為 2000 個半形字元。 |
certificationCode |
證照號碼。長度上限為 2000 個半形字元。 |
certificationValue |
證照值 (又稱等級、等級或成績),例如「A+」、「C」、「黃金」。長度上限為 2000 個半形字元。 |
ProductStructuredTitle
結構化標題,適用於透過演算法 (AI) 生成的標題。
JSON 表示法 |
---|
{ "digitalSourceType": string, "content": string } |
欄位 | |
---|---|
digitalSourceType |
數位來源類型,例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。 |
content |
標題文字長度上限為 150 個字元 |
ProductStructuredDescription
結構化說明:適用於演算法 (AI) 生成的說明。
JSON 表示法 |
---|
{ "digitalSourceType": string, "content": string } |
欄位 | |
---|---|
digitalSourceType |
數位來源類型,例如「training_algorithmic_media」。按照 IPTC 設定。長度上限為 40 個半形字元。 |
content |
說明文字的長度上限為 5000 個字元 |
ProductStatus
產品狀態、資料驗證問題,也就是以非同步方式計算的產品相關資訊。
JSON 表示法 |
---|
{ "destinationStatuses": [ { object ( |
欄位 | |
---|---|
destinationStatuses[] |
產品的預定目的地。 |
itemLevelIssues[] |
產品相關問題的清單。 |
creationDate |
項目的建立日期 (採用 ISO 8601 格式)。 |
lastUpdateDate |
項目上次更新日期 (採用 ISO 8601 格式)。 |
googleExpirationDate |
商品的到期日 (採用 ISO 8601 格式)。 |
DestinationStatus
產品狀態的目的地狀態。
JSON 表示法 |
---|
{
"reportingContext": enum ( |
欄位 | |
---|---|
reportingContext |
報表結構定義的名稱。 |
approvedCountries[] |
提供優惠的國家/地區代碼 (ISO 3166-1 alpha-2)。 |
pendingCountries[] |
優惠尚待核准的國家/地區代碼清單 (ISO 3166-1 alpha-2)。 |
disapprovedCountries[] |
拒登商品的國家/地區代碼清單 (ISO 3166-1 alpha-2)。 |
ItemLevelIssue
產品狀態的 ItemLevelIssue。
JSON 表示法 |
---|
{ "code": string, "severity": enum ( |
欄位 | |
---|---|
code |
問題的錯誤代碼。 |
severity |
這個問題對優惠放送的影響。 |
resolution |
商家是否能解決問題。 |
attribute |
屬性名稱 (如果問題是由單一屬性引起)。 |
reportingContext |
問題適用的檢舉內容。 |
description |
問題的簡短英文說明。 |
detail |
問題的詳細英文說明。 |
documentation |
協助解決問題的網頁網址。 |
applicableCountries[] |
適用於優惠的國家/地區代碼清單 (ISO 3166-1 alpha-2)。 |
嚴重性
問題對產品放送的影響。
列舉 | |
---|---|
SEVERITY_UNSPECIFIED |
未指定。 |
NOT_IMPACTED |
這個問題代表警告,對產品不會直接影響。 |
DEMOTED |
產品降低排名,且在搜尋結果中的成效可能有限 |
DISAPPROVED |
問題導致產品遭到拒登。 |
方法 |
|
---|---|
|
從 Merchant Center 帳戶擷取已處理的產品。 |
|
請在 Merchant Center 帳戶中列出已處理的產品。 |