REST Resource: accounts.products

資源：產品

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

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

JSON 表示法 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
欄位
name

string

產品名稱。格式："{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

僅供輸出。產品的通路。
offerId

string

僅供輸出。產品的專屬 ID。這也適用於產品輸入和已處理的產品。系統會移除開頭和結尾的空白字元，提交時則會以一個空白字元取代多個空白字元。詳情請參閱產品資料規格。
contentLanguage

string

僅供輸出。以兩個字母表示產品的 ISO 639-1 語言代碼。
feedLabel

string

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

string

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

object (Attributes)

僅供輸出。產品屬性清單。
customAttributes[]

object (CustomAttribute)

僅供輸出。自訂 (商家提供) 屬性的清單。同時，您也能透過通用表單 (例如 { "name": "size type", "value": "regular" }) 提交資料規格的任何屬性。提交 API 未明確公開的屬性 (例如 Buy on Google 所使用的其他屬性) 時，就相當實用。
productStatus

object (ProductStatus)

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

string (int64 format)

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

如果設定，當版本號碼低於現有產品的目前版本號碼時，系統就不會插入。使用目前的versionNumber重新插入功能 (例如，30 天後更新產品)。

這項功能僅支援插入主要資料來源。

如果作業失敗，系統會擲回取消的例外狀況。

屬性

屬性。

JSON 表示法 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": 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,
  "gtin": 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 格式)。
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 之間 (不含 0 和 3000)。
productLength

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

以單位提供的產品重量表示產品重量。這個值必須介於 0 至 2000 之間 (不含 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 產品類別。
gtin

string

商品的全球交易品項識別碼 (GTIN)。
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

可使用任意方式將項目分組，僅適用於單次轉換百分比，否則不建議使用。
adsRedirect

string

允許廣告主在產品廣告顯示時覆寫商品網址。
displayAdsId

string

動態再行銷廣告活動項目的 ID。
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

產品的訂閱費用。

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

string

會員方案的標籤。這個內部標籤可用於識別商家實體和會員方案實體之間的關係。你必須提供標籤，系統才能將下列資產 (例如價格和點數) 與商家建立關聯。相應的計畫必須連結至商家帳戶。
tierLabel

string

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

object (Price)

指定等級的會員價格，也就是即時折扣價格。必須小於或等於原價。
cashbackForFutureUse

object (Price)

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

string (int64 format)

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

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][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

string (int64 format)

從收到訂單到出貨之間的最長處理時間 (含) 以工作天為單位。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

string (int64 format)

從訂單出貨後到商品送達以工作天為單位的最短運送時間 (含)。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

string (int64 format)

從訂單出貨到商品出貨所需的最長運送時間 (含) 以工作天計。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 (Price)
  }
}
欄位
country

string

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

object (Price)

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

ShippingWeight

產品的運送包裹重量。

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

number

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

string

值的單位。

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

產品的計價單位。

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 的產品屬性。舉例來說，電視產品的屬性可以是「螢幕解析度」或「螢幕尺寸」。

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

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

認證

產品認證，最初是依據歐盟 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

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

string

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

ProductStructuredDescription

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

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

string

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

string

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

ProductStatus

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

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
欄位
destinationStatuses[]

object (DestinationStatus)

產品的預定目的地。
itemLevelIssues[]

object (ItemLevelIssue)

產品相關問題的清單。
creationDate

string (Timestamp format)

項目的建立日期 (採用 ISO 8601 格式)。
lastUpdateDate

string (Timestamp format)

項目上次更新日期 (採用 ISO 8601 格式)。
googleExpirationDate

string (Timestamp format)

商品的到期日 (採用 ISO 8601 格式)。

DestinationStatus

產品狀態的目的地狀態。

JSON 表示法 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
欄位
reportingContext

enum (ReportingContextEnum)

報表結構定義的名稱。
approvedCountries[]

string

提供優惠的國家/地區代碼 (ISO 3166-1 alpha-2)。
pendingCountries[]

string

優惠尚待核准的國家/地區代碼清單 (ISO 3166-1 alpha-2)。
disapprovedCountries[]

string

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

ItemLevelIssue

產品狀態的 ItemLevelIssue。

JSON 表示法 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
欄位
code

string

問題的錯誤代碼。
severity

enum (Severity)

這個問題對優惠放送的影響。
resolution

string

商家是否能解決問題。
attribute

string

屬性名稱 (如果問題是由單一屬性引起)。
reportingContext

enum (ReportingContextEnum)

問題適用的檢舉內容。
description

string

問題的簡短英文說明。
detail

string

問題的詳細英文說明。
documentation

string

協助解決問題的網頁網址。
applicableCountries[]

string

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

嚴重性

問題對產品放送的影響。

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

方法

get

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

list

 請在 Merchant Center 帳戶中列出已處理的產品。