版本資訊 (v2.1)

2024 年 4 月 11 日

已變更「LoyaltyPoints」的瀏覽權限

2024 年 4 月 10 日

已新增「LoyaltyProgram」

2024 年 4 月 9 日

產品服務

產品資源

新增 structuredTitle 和 structuredDescription，提供 AI 產生的產品名稱和說明。

2024 年 4 月 3 日

商家支援服務

新增 user_input_action_option 欄位，可讓合作夥伴要求新的動作類型：BuiltInUserInputAction。這個動作可讓合作夥伴直接在自家應用程式中，為商家建構複雜的自助式功能，而不必將他們重新導向至 Merchant Center。

為 BuiltInUserInputAction 新增 TriggerAction 方法。如要使用這個方法，請向這份表單提出要求。

2024 年 3 月 27 日

產品服務

產品資源

已在「自動折扣」和「動態促銷活動」專案中新增 AutoPricingMinPrice 保護措施，確保商家優惠折扣不會將產品價格降低至低於這個值。進而保留優惠的價值和獲利能力

2024 年 3 月 15 日

針對搜尋和購物的 Buy on Google 服務即將停用。在 2024 年 10 月 31 日前，您還是可以使用 orders.list 和 orders.get 查看現有訂單。

2024 年 3 月 8 日

報表服務

在 Reports 服務中加入TopicTrendsView報表。

詳情請參閱報表指南。

2024 年 3 月 6 日

報表服務

新增點擊次數潛力值區和產品排名。

詳情請參閱報表指南。

2024 年 2 月 19 日

ConversionSources 服務

已移除下列做為有效轉換來源的值：

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

移除回溯期天數 60 和 90 的選項，並新增 40 做為有效選項。

2024 年 1 月 17 日

銷售點 (POS) 服務

為 PosStore 中的 matching_status_hint 欄位新增值，讓使用者進一步瞭解商店比對失敗的原因。

2024 年 1 月 11 日

帳戶服務

已將 localProductManager 和 localProductManagement 分別新增為 link 方法的連結類型和服務。這些連結可讓帳戶 連結至管理店面產品資料的目的

2023 年 11 月 29 日

商家支援服務

新增 VERIFY_IDENTITY_IN_MERCHANT_CENTER 外部動作類型，用於在 Merchant Center 中驗證身分。

銷售點 (POS) 服務

在 PosStore 中新增 matching_status 和 matching_status_hint 欄位，讓使用者瞭解 Pos Store 與 Google 商家檔案商店的相符狀態，以及發生問題時的提示。

2023 年 11 月 15 日

不再支援 repricingrules 和 repricingrules.repricingreports 端點。

2023 年 11 月 1 日

運送設定服務

已不再支援 shipment_type=pickup。

2023 年 10 月 18 日

帳戶服務

新增 Business Identity 欄位，讓商家可以自行識別特定消費者值。

2023 年 10 月 10 日

已將「Collection Point」新增為運送設定服務的運送類型。取貨地點配送服務是由第三方 (例如非商家擁有) 提供的服務，用來將商品送至第三方關聯地點 (例如 UPS Access Point)，而不是直接將商品交付到住家。

2023 年 9 月 18 日

店面商品目錄廣告設定服務

新增 setOmnichannelExperience 方法，可讓使用者設定全通路體驗 (即本地店面和取貨設定)。目前，只有信任銷售點 (POS) 供應商可以啟用相關設定的使用者才能使用這項設定。

2023 年 9 月 7 日

Buy on Google 即將淘汰

在 GetBuyOnGoogleProgramStastus 方法中新增 DEPRECATED 狀態。無法在此類狀態重新啟用或暫停程式。

2023 年 9 月 4 日

商家支援服務

針對需要在帳戶層級解決的產品問題新增 FIX_ACCOUNT_ISSUE 內建操作。新增 SHOW_ADDITIONAL_CONTENT 內建動作，用於提供國家主管機關的理由。

2023 年 8 月 28 日

促銷服務

在 Promotions 服務中開啟 list 方法，不受限制存取。

2023 年 8 月 22 日

商家支援服務

推出「商家支援服務」。這項服務支援帳戶問題和產品問題的相關支援內容。

2023 年 8 月 4 日

報表服務

在報表服務中新增「關閉競爭對手的競爭曝光率」報表。

詳情請參閱報表指南。

2023 年 7 月 25 日

銷售點 (POS) 服務

庫存資源

新增 pickup_method 和 pickup_sla 欄位，讓商家可提交取貨資訊和商品目錄資料。

2023 年 7 月 14 日

報表服務

在報表服務中新增競爭曝光率報表。

詳情請參閱報表指南。

2023 年 7 月 7 日

產品服務

產品資源

新增了 virtualModelLink，以提供 3D 模型圖片的網址。

2023 年 7 月 4 日

產品服務

產品資源

新增 certifications 欄位來提供產品認證，例如歐盟 EPREL 資料庫的產品能源效率標籤。

2023 年 6 月 26 日

運送設定服務

當地出貨

新增了 no_delivery_post_cutoff 欄位，如果商家將運送服務設為 n 天本地商品配送，則商家可選擇不顯示 N 天以上的本地運費。

2023 年 5 月 29 日

促銷服務

已為 Promotions 服務新增 list 方法。

推薦服務

請在推薦服務的 ReportInteraction 方法中啟用互動關閉功能。

2023 年 5 月 9 日

Cloud Retail 目的地

Cloud Retail 其他屬性

新增 Cloud Retail 其他屬性欄位。這是重複欄位，適合使用 Cloud Retail 目的地的客戶使用。使用 Cloud Retail 計畫時，也可以使用此欄位。系統會將這項資訊對應到 Google Cloud Retail 產品模型中的屬性欄位。

2023 年 5 月 22 日

促銷服務

已為 Promotions 服務新增 list 方法。

2023 年 4 月 11 日

運送設定服務

當地出貨

為建立新的運送設定的商家新增本地交貨方式選項。他們可以在新的 storeConfig 欄位中調整當地商店的設定。包括提供本地運送商店的服務範圍半徑、截止時間和商店代碼。

4 月 3 日

推薦服務

推出推薦服務。這項服務會提供改善商家帳戶效能的建議方式，並可讓您回報實用建議的商家點擊次數。

2023 年 2 月 20 日

帳戶服務

帳戶資源

在「帳戶」資源中新增 Account.ConversionSettings 部分。

ConversionSources 服務

新增轉換來源服務，支援管理轉換來源 (位於 Merchant Center 的「轉換設定」部分)。

2023 年 2 月 16 日

運送設定服務

商店代碼驗證

系統現在會驗證商家代碼，確保這些代碼屬於商家，再更新運送設定。

店面商品目錄廣告商家驗證

以商家 ID 註冊的計畫現在會先驗證，再更新運送設定。商家必須加入下列任一計畫：

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

2023 年 2 月 9 日

促銷活動服務

將促銷活動服務擴充為另外 6 個 targetCountry 選項，並支援當地 contentLanguage：

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

2023 年 1 月 12 日

產品服務

產品資源

新增了 lifestyleImageLinks，以提供生活風格圖片的網址。

2022 年 11 月 24 日

促銷服務

在「Promotions.PromotionStatus」Promotions.PromotionStatus部分新增「promotionStatus」欄位。此為唯讀欄位。

2022 年 11 月 15 日

報表服務

在報表服務中加入市場洞察報表。

您現在可以使用「報表」服務查詢下列內容：

詳情請參閱報表指南。

2022 年 11 月 7 日

Datafeeds 服務

開始支援 Datafeeds 服務的 feedLabel。

2022 年 9 月 14 日

已更新 feedLabel，使其接受任何字串。

2022 年 8 月 9 日

已為產品新增 feedLabel。

您現在可以使用 feedLabel (而非 targetCountry) 來指定優惠 ID 的國家/地區。優惠 ID 現在建構為 online:language:feedLabel:offerId。

為顧及回溯相容性，系統已為現有的動態饋給自動填入 feedLabel 的 targetCountry 值。

淘汰了 targetCountry。

為支援全球優惠，Content API for Shopping 已淘汰 targetCountry 欄位。建議您改用 shipping 欄位指定指定國家/地區。

targetCountry 現在會自動填入您在 feedLabel 中提供的值。

詳情請參閱這篇網誌文章「動態饋給標籤取代 Content API for Shopping 中的指定國家/地區」。

2021 年 12 月 8 日

帳戶服務

帳戶資源

在「帳戶」資源中新增 Account.AutomaticImprovements 部分。

這個新章節可讓商家自動更新商品、改善圖片和運送設定。

2021 年 10 月 25 日

促銷服務

將 Get promotion (取得促銷活動) 新增至 promotion API。

2021 年 10 月 11 日

運送設定 API

在 ShipSettings 資源中新增 warehouse 欄位，可讓商家管理可用於 WarehouseBasedDeliveryTime 的倉儲。

在 WarehouseBasedDeliveryTime 中新增 warehouseName 欄位，以根據倉儲名稱參照 warehouse。

2021 年 10 月 4 日

帳戶服務

帳戶資源

在「Accounts.BusinessInformation」區段新增「phone_verification_status」欄位。此為唯讀欄位，由 Accounts.VerifyPhoneNumber 設定)。

2021 年 9 月 13 日

BuyOnGooglePrograms 服務

BuyOnGoogleProgramStatus 資源

在 BuyOnGooglePrograms.BuyOnProgramStatus 資源中新增欄位：線上銷售管道、商業模式和客戶服務電話。

新的 UpdateBuyOnGoogleProgramStatus 方法

新增 UpdateBuyOnGoogleProgramStatus 方法，允許更新擴充的 BuyOnGooglePrograms.BuyOnProgramStatus 資源。

2021 年 9 月 6 日

帳戶服務

帳戶資源

在 Accounts.BusinessInformation 部分新增「korean_business_Registration_number」欄位只有在明確設為空字串的情況下，系統才會清除這個欄位。

2021 年 8 月 30 日

促銷服務

已新增可提供插入促銷活動的促銷活動服務。

訂單服務

新增了 orders/captureOrder 方法，以便在出貨前擷取資金。

新訂單取消原因：FAILED_TO_CAPTURE_FUNDS

產品服務

產品資源

新增了 productLength、productHeight、productWidth 和 productWeight，以提供產品尺寸和重量。

2021 年 8 月 9 日

重新定價規則服務

重新定價規則類型

RepricingRuleType 欄位的新列舉值。

新增了 TYPE_SALES_VOLUME_BASED 和 TYPE_COMPETITIVE_PRICE。

2021 年 5 月 17 日

訂單退貨標籤服務

在 CreateReturnRequest 中新增了「product_id」欄位。商家可以指定 product_id 或 line_item_id 來識別要傳回的項目。

產品服務

新增更新現有產品的方法。您可以只提供需要更新的欄位 (而非整個產品)，藉此更新產品。

2021 年 5 月 3 日

訂單退貨標籤服務

新增商家管理退貨 (MMR) 標籤的上傳方法。您可以使用新的 orderreturns.labels.create 上傳退貨標籤，與客戶分享。

2021 年 4 月 26 日

運送設定 API

DeliveryTime 中的新 warehouseBasedDeliveryTimes 欄位，用於支援運送服務，根據倉庫位置和所選貨運公司服務計算預估送達日期。

在 CarriersCarrier 物件中新增 eddServices 欄位，用於傳回適用於計算預估送達日期的服務名稱。

2021 年 4 月 12 日

產品服務

產品資源

新增 additionalSizeType 欄位，每個產品最多可支援 2 種尺寸類型。

運送欄位變更：將 minHandlingTime、maxHandlingTime、minTransitTime 和 maxTransitTime 新增至 ProductShipping，以便提供商品層級的運送速度。

2021 年 1 月 28 日

帳戶服務

開始對 AccountLabel 和 Account 資源新增自動標籤支援。詳情請參閱 CSS 標籤管理指南的「CSS 標籤類型」一節。

2020 年 10 月 5 日

CSSES 服務

CSS 資源

新增 csses 服務，用於擷取 CSS 網域相關資訊並為其指派標籤。AccountLabel 資源現在也能用於建立及列出 CSS 群組層級標籤。詳情請參閱「CSS 標籤管理」。

2020 年 8 月 24 日

產品服務

產品資源

新增 shoppingAdsExcludedCountries 欄位，用於在特定國家/地區排除優惠廣告。

產品狀態資源

destinationStatuses 物件中新增 approvedCountries、pendingCountries 和 disapprovedCountries 欄位，可提供 targetCountry 以外的優惠狀態資訊。

新的 itemLevelIssues.applicableCountries 欄位。

2020 年 8 月 10 日

帳戶服務

新增 AccountLabel 資源，用於管理 CSS Center 的 Merchant Center 帳戶標籤。CSS Center 使用者現在也可以列出自己的 Merchant Center 帳戶，並使用 accounts.list、accounts.get 和 accounts.updatelabels 方法為他們指派標籤。詳情請參閱「CSS 標籤管理」。

2020 年 6 月 19 日

產品服務

產品資源

新欄位

新的 productDetails、productHighlights、subscriptionCost 和 canonicalLink 欄位。

2020 年 6 月 2 日

訂單服務

新增辦理退款且不需退貨的新方法。您可以透過新的 orders.refunditem 和 orders.refundorder 辦理訂單退款，即使客戶沒有退回訂單也沒問題。

2020 年 4 月 27 日

訂單退貨服務

新增了 acknowledge 和 process 方法，以及適用於讀取方法 (list、get) 的新篩選器和欄位。

Google 我的商家連結

新增使用 GMB 帳戶 ID 將 Merchant Center 帳戶連結至 GMB 帳戶的功能。

2020 年 4 月 14 日

結算報告 API

新增取得結算報表的服務。

2020 年 3 月 9 日

店面商品目錄資料 API

新增用於提交店面商品目錄資料的服務。

2020 年 3 月 2 日

Pub/Sub 通知設定 API

新增用於管理 pubsub 通知設定的服務。

2019 年 12 月 3 日

產品服務

新增對多重客戶帳戶補充 Content API 動態饋給的支援。

2019 年 9 月 11 日

訂單服務

新增訂單中的自取服務及相應的沙箱功能。

2019 年 8 月 14 日

新服務

新增 Buy on Google 的退貨政策和退貨地址服務。

訂單服務

訂單資源

新欄位

新的 quantityUndeliverable 欄位。

2019 年 8 月 7 日

訂單服務

訂單資源

新欄位

已將新的 loyaltyInfo 和 invoiceReceivingEmail 欄位新增至訂單資源。

2019 年 7 月 1 日

產品服務

支援「產品」服務中新增的補充 Content API 動態饋給。

2019 年 6 月 11 日

訂單服務

訂單和 TestOrder 資源

附加價格調整

新增 lineItem[].adjustments 欄位，其中包含調整後原始明細項目的價格，以及因套用促銷活動而產生的稅金。

2019 年 2 月 14 日

此版本推出的變更

不再支援模擬測試

dryRun 參數已從 2.1 版中移除。這適用於所有 API 呼叫。

不再支援修補方法

下列服務不再支援 patch 方法：

  • 客戶
  • 帳戶稅
  • 資料動態饋給
  • Liasettings
  • 運送設定

移除 HTTP BATCH 方法

所有 HTTP BATCH 方法都已從 2.1 版中移除。請改用 customBatch。受影響的服務如下：

  • 客戶
  • 帳戶狀態
  • 資料動態饋給
  • 資料動態饋給狀態
  • Liasettings
  • 訂單報表
  • 排名
  • 產品
  • 產品狀態
  • 運送設定

帳戶服務

更新

要求中的欄位 businessInformation 和 googleMyBusinessLink 欄位是在 Content API v2 首次啟動後導入。因此，如果商家未提供 update，系統會採取安全保護措施，防止商家意外刪除這兩個欄位中的資訊。

在第 2 版中，商家必須明確提供空白主體 ( {})，才能刪除這些欄位。在 2.1 版中，如果您提供空白的主體或未提供這些欄位，系統就會刪除欄位。

帳戶資源

AdWords -> Google Ads 品牌重塑

隨著 AdWords 更名為 Google Ads，下列 AdWords 相關欄位已重新命名：

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
移除已淘汰的欄位和值

已移除淘汰欄位 reviewsUrl。此外，系統已移除 adsLinks、googleMyBusinessLink 和 youtubeChannelLinks 的連結狀態 inactive。

Accountstatuses 服務

AccountStatus 資源

移除資料品質問題

這些內容已由 itemLevelIssues 取代。

Datafeed 服務

Datafeed 資源

移除已淘汰欄位

contentLanguage、targetCountry 和 intendedDestinations 欄位已移除，並替換為 targets 中的 country、language、includedDestinations 和 excludedDestinations。

移除商品目錄更新

已移除 product inventory update 類型的動態饋給。

庫存服務

v2 inventory 服務已移除，並替換為 2.1 版中的兩個新功能：

訂單服務

CancelLineItem

已移除要求中的 amount、amountPretax 和 amountTax 欄位。系統現在會自動計算退款金額。

CustomBatch

CustomBatch 已從 2.1 版中移除。

InStoreRefundLineItem

amountPretax 和 amountTax 欄位已由 priceAmount 和 taxAmount 分別取代。視訂單地點而定，priceAmount 欄位可能是稅前或稅後金額。

退款

此方法已移除。請改用 returnRefundLineItem。

ReturnLineItem

此方法已移除。請改用 returnRefundLineItem，而不提供退款金額。

ReturnRefundLineItem

amountPretax 和 amountTax 欄位已由 priceAmount 和 taxAmount 分別取代。視訂單地點而定，priceAmount 欄位可能是稅前或稅後金額。

ShipLineItem

要求中的 carrier、shipmentId 和 trackingId 欄位已移至 shipmentInfos。

訂單和 TestOrder 資源

新增宣傳格式

v2.1 推出了新的宣傳格式。您無法建立有促銷活動的測試訂單。

移除已淘汰欄位

paymentMethod 欄位已移除，且 billingAddress 和 predefinedBillingAddress 現在分別成為 Order 和 TestOrder 中的頂層欄位。

此外，customer.explicitMarketingPreference 已移除，並由 Order 和 TestOrder 中的 customer.marketingRightsInfo 取代。

已移除淘汰欄位 customer.email。

Order 資源中的「promotions」欄位格式已變更。

Orderpayments 服務

這項服務已從 2.1 版中移除。

產品服務

insert 的回應僅包含以下屬性：

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

系統不會再傳回不嚴重的警告和錯誤。這樣更容易與動態饋給規則和其他進階動態饋給管理功能整合。

現在，插入產品需要幾分鐘的時間，才能由 get 或 list 擷取。

傳回的優惠 ID 不再保證與輸入優惠 ID 相同。

系統會在插入產品前驗證價格。值字串只能使用下列字元：+、-、. 和數字 (0-9)。現已不支援逗號。

產品資源

以遞迴自訂屬性取代 CustomGroup

以往，您可以在 v2 的同一個自訂群組中新增自訂屬性，藉此將自訂屬性分組。在 v2.1 中，自訂屬性現在會遞迴，因此不需要自訂群組。

除了原始的 value 欄位以外，自訂屬性現在還多了一個 groupValues 欄位；必須設定其中一個欄位，意味著不可同時設定或省略。

由於商家可能會在 v2 和 2.1 之間切換，因此產品可能會有遞迴自訂屬性，這些屬性在 v2 中不能表示，因為自訂群組最多只能有兩個層級。在這種情況下，自訂屬性群組會遭到截斷。

移除 customAttributes 中的類型和單位

在 2.1 版中，自訂屬性不再包含 type 和 unit。系統會將單位附加至 value (如有)，且應自動偵測類型。如果是範例，請在 2.1 版中使用「1.23 EUR」或「5.6 公分」做為 value。

「ProductTypes」取代了 productType 與 additionalProductTypes

先前，產品類型儲存在兩個欄位中，第一個類型儲存在單一欄位 productType 中，其餘欄位則儲存在重複欄位 additionalProductTypes 中。在 2.1 版中，這兩個欄位已由單一重複的欄位 productTypes 取代。

目的地屬性會替換為 includeDestinations 和 excludedDestinations

在重複欄位 destinations 中，目的地是第 2 版中的目的地名稱和意圖組合清單。這個欄位已由下列兩個重複欄位取代：includedDestinations 和 excludedDestinations。預設啟用的目的地不需要包含在 includedDestinations. 中，這將與動態饋給中的目的地覆寫設定相符。

隨著 AdWords 更名為 Google Ads，下列 AdWords 相關欄位已重新命名：

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
移除已淘汰欄位

下列已淘汰的欄位已移除：

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

產品狀態服務

取得並列出

移除了 product 屬性和 includeAttributes 參數。如要擷取與狀態對應的產品屬性，請使用 Products 服務和新 productId 欄位的值。

清單

已移除 includeInvalidInsertedItems 參數。現在無論產品是否有效，系統現在都會傳回所有產品，這表示 list 的行為現在如同 includeInvalidInsertedItems 一律設為 true 時的行為。

產品狀態資源

DestinationsStatuses

destinationStatuses 中的 intention、approvalStatus 和 approvalPending 欄位已替換為 status，該字串可以是 approved、disapproved 或 pending 其中之一。

移除資料品質問題

這些內容已由 itemLevelIssues 取代。