Attributes

屬性。

JSON 表示法 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "gtin": [
    string
  ],
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
欄位
expirationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

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

string

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

object (Price)

商品價格。
installment

object (Installment)

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

object (SubscriptionCost)

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

object (LoyaltyPoints)

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

object (LoyaltyProgram)

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

string

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

object (Price)

商品的廣告特價。
salePriceEffectiveDate

object (Interval)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

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

object (Shipping)

運送規則。
freeShippingThreshold[]

object (FreeShippingThreshold)

產品必須符合哪些條件，才能提供免運費服務。
shippingWeight

object (ShippingWeight)

運送商品的重量。
shippingLength

object (ShippingDimension)

運送商品的長度。
shippingWidth

object (ShippingDimension)

運送包裹的寬度。
shippingHeight

object (ShippingDimension)

運送商品的高度。
sizeTypes[]

string

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

object (Tax)

稅務資訊。
unitPricingMeasure

object (UnitPricingMeasure)

項目的測量單位和尺寸。
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

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

string

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

object (Price)

銷貨成本。用於毛利報表。
productDetails[]

object (ProductDetail)

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

string

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

string

廣告主指定的建議值。
promotionIds[]

string

促銷活動的專屬 ID。
includedDestinations[]

string

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

string

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

string

清單列出要從購物廣告目的地排除商品的國家/地區代碼 (ISO 3166-1 alpha-2)。系統會從資料來源設定中移除這份清單中的國家/地區。
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

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

object (Certification)

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

object (Price)

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

boolean

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

boolean

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

string

項目名稱。
description

string

項目說明。
adult

boolean

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

string

商品的目標年齡層。
availability

string

商品的供應情形狀態。
brand

string

商品品牌。
color

string

商品的顏色。
condition

string

商品的狀況或狀態。
gender

string

商品的目標客群性別。
googleProductCategory

string

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

string

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

string

商品製造原料。
mpn

string

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

string

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

string

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

string

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

string

產品的稅務類別，用於在帳戶層級稅務設定中設定詳細的稅務關聯。
energyEfficiencyClass

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

string

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

number

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

string

商品的取貨選項。
pickupSla

string

商品的到店取貨時程。
customLabel0

string

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

string

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

string

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

string

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

string

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

string

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

string

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

object (ProductStructuredTitle)

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

object (ProductStructuredDescription)

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

分期付款

代表分期付款的訊息。

JSON 表示法 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
欄位
months

string (int64 format)

買家須支付的期數。
amount

object (Price)

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

object (Price)

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

string

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

SubscriptionCost

產品的 SubscriptionCost。

JSON 表示法 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
欄位
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

object (Price)

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

SubscriptionPeriod

產品的訂閱期。

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

LoyaltyPoints

代表會員點數的訊息。

JSON 表示法 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
欄位
name

string

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

string (int64 format)

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

number

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

LoyaltyProgram

代表會員方案的訊息。

JSON 表示法 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string,
  "memberPriceEffectiveDate": {
    object (Interval)
  },
  "shippingLabel": string
}
欄位
programLabel

string

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

string

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

object (Price)

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

object (Price)

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

string (int64 format)

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

object (Interval)

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

string

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

ProductDimension

產品的尺寸。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

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

string

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

ProductWeight

產品重量。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

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

string

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

運費

產品的運送方式。

JSON 表示法 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
欄位
price

object (Price)

固定運費，以數字表示。
country

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

FreeShippingThreshold

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

JSON 表示法 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
欄位
country

string

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

object (Price)

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

ShippingWeight

產品的運送包裹重量。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

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

string

值的單位。

ShippingDimension

產品的 ShippingDimension。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

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

string

值的單位。

稅金

產品稅金。

JSON 表示法 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
欄位
rate

number

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

string

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

string

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

boolean

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

string (int64 format)

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

string

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

UnitPricingMeasure

產品的 UnitPricingMeasure。

JSON 表示法 
{
  "value": number,
  "unit": string
}
欄位
value

number

項目的測量單位。
unit

string

測量單位。

UnitPricingBaseMeasure

產品的 UnitPricingBaseMeasure。

JSON 表示法 
{
  "value": string,
  "unit": string
}
欄位
value

string (int64 format)

單位價格的分母。
unit

string

分母的單位。

ProductDetail

產品詳細資料。

JSON 表示法 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
欄位
sectionName

string

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

string

產品詳細資料的名稱。
attributeValue

string

產品詳細資料的值。

CloudExportAdditionalProperties

Cloud Retail API 的產品屬性。舉例來說，電視產品的屬性可能是「Screen-Resolution」或「Screen-Size」。

JSON 表示法 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
欄位
textValue[]

string

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

string (int64 format)

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

number

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

string

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

boolean

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

number

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

number

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

string

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

認證

產品認證：最初推出這項功能，是為了讓產品符合歐盟能源效率標籤法規，並使用歐盟 EPREL 資料庫。

JSON 表示法 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
欄位
certificationAuthority

string

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

string

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

string

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

string

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

ProductStructuredTitle

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

JSON 表示法 
{
  "digitalSourceType": string,
  "content": string
}
欄位
digitalSourceType

string

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

string

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

ProductStructuredDescription

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

JSON 表示法 
{
  "digitalSourceType": string,
  "content": string
}
欄位
digitalSourceType

string

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

string

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