版本資訊 (v2.1)

2024 年 8 月 26 日 (比原本的回覆速度更快)

訂單相關 API 停用後，下列服務已遭淘汰： - orderinvoices - orderreports - orderreturns - orderreturns.labels 年 - orders

對上述服務的呼叫會失敗，並收到 Service was not found on the server 回應。

OrderTrackingSignals 服務並未淘汰，日後可繼續使用。

2024 年 8 月 10 日

Buy on Google 服務

隨著 Buy on Google API 停用，BuyOnGoogleProgramService 內的所有方法都會因 service was not found on the server 而失敗。

2024 年 7 月 19 日

產品服務

已新增 member_price_effective_date 欄位。這項更新可讓你指定忠誠度的日期範圍 (如適用) 會員價格有效。如未提供欄位值，系統會一律採用會員價格 有效。

2024 年 5 月 20 日

產品服務

已新增LoyaltyPrograms。這項更新可讓你為單一產品提供多個會員等級，並設定不同的會員點數、價格等。 請使用這個欄位取代單一 LoyaltyProgram 欄位。

報表服務

淘汰的 Buy on Google 指標如下： MerchantPerformanceView敬上 表格。更新之後，如果您擷取任何 Buy on Google 指標，系統將傳回 0。這個 以及過去日期的歷來值。

詳情請參閱「淘汰 Buy on Google」一文。

2024 年 5 月 13 日

產品服務

產品資源

認證欄位變更：已新增 certificationValue敬上 加入 ProductCertification 欄位，以便提供認證值 (又稱「等級」、「等級」或「年級」) 方便使用者上傳 認證資訊 即使發證機構未核發認證號碼或號碼也是如此。

詳情請參閱 產品指南。

2024 年 5 月 6 日

報表服務

在「PriceInsightsProductView」資料表新增成效值區。 「效益」代表調整價格對哪些產品最有幫助。這項評分會考量調整特價後提升的預估成效，以及目前價格和建議價格之間的差額。

2024 年 4 月 24 日

產品服務

產品資源

已為「分期付款」新增 downpayment 和 creditType 選用欄位：

  • downpayment 提供買家須預付的單筆款項。
  • creditType 提供分期付款類型 (finance 或 lease)。這個欄位僅適用於車輛廣告。

2024 年 4 月 11 日

產品服務

產品資源

  • 已新增商品層級運送的免運費門檻屬性 (FreeShippingThreshold)。這項屬性可讓商家輸入最低產品價格，才能免費使用運費。
  • 已變更 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 日

報表服務

已將 TopicTrendsView 報表新增至 Reports 服務。

詳情請參閱報告 指南。

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 新增為有效回溯期 如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇

2024 年 1 月 17 日

銷售點 (POS) 服務

為matching_status_hint PosStore ，方便使用者進一步瞭解商店比對結果 失敗。

2024 年 1 月 11 日

帳戶服務

將 localProductManager 和 localProductManagement 新增為連結類型 分別用於 link 方法。完成上述步驟後 管理店面產品資料時

2023 年 11 月 29 日

商家支援服務

已為身分新增 VERIFY_IDENTITY_IN_MERCHANT_CENTER 個外部動作類型 您需要在 Merchant Center 中執行這項驗證

銷售點 (POS) 服務

已將 matching_status 和 matching_status_hint 欄位新增至 PosStore 方便使用者瞭解 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 做為運送設定服務的新運送類型。A 罩杯 取貨地點配送服務是由第三方提供 (例如 商家自有)，以便將商品運送至第三方聯盟地點 (例如 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+1 天到貨 本地運送服務。

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 在 Accounts 資源中。

ConversionSources 服務

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

2023 年 2 月 16 日

運送設定服務

商店代碼驗證

系統現已驗證商家代碼，確認該代碼屬於商家 運送設定已更新。

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

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

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

2023 年 2 月 9 日

促銷活動服務

額外新增 6 項促銷活動服務 targetCountry敬上 提供店面選項 contentLanguage support.:

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

2023 年 1 月 12 日

產品服務

產品資源

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

2022 年 11 月 24 日

促銷服務

已新增「promotionStatus」欄位在 Promotions.PromotionStatus 區段中)。這個 為唯讀欄位。

2022 年 11 月 15 日

報表服務

將「市場洞察」報表新增至報表服務。

您現在可以查詢報表服務執行下列作業：

詳情請參閱報告 指南。

2022 年 11 月 7 日

Datafeeds 服務

開始支援feedLabel Datafeeds 服務。

2022 年 9 月 14 日

更新日期 feedLabel敬上 可接受任何字串。

2022 年 8 月 9 日

已新增 feedLabel敬上 但 AI 也很類似

您現在可以使用 feedLabel 取代 targetCountry 指定要提供優惠 ID 的國家/地區。優惠 ID 現已建構為 online:language:feedLabel:offerId。

feedLabel 已自動填入以下項目的targetCountry值： 確保回溯相容性

淘汰了 targetCountry。

為支援全球產品/服務，Content API for Shopping 已淘汰 「targetCountry」欄位。建議您改用 shipping敬上 ] 欄位，以指定國家/地區。

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

請參閱網誌文章動態饋給標籤取代 Content API 中的指定國家/地區， 購物 ，掌握更多詳細資訊。

2021 年 12 月 8 日

帳戶服務

帳戶資源

已新增區段 Account.AutomaticImprovements 在 Accounts 資源中。

商家可在這個新專區自動更新商品，改善服務品質 圖片和運送設定

2021 年 10 月 25 日

促銷服務

將「取得促銷」新增至「Promotions API」。

2021 年 10 月 11 日

Shipping Settings API

在 ShippingSettings 中新增「warehouse」欄位 資源 讓商家能管理可用於 WarehouseBasedDeliveryTime.

在以下位置新增「warehouseName」欄位： WarehouseBasedDeliveryTime 代表 倉儲 倉儲名稱。

2021 年 10 月 4 日

帳戶服務

帳戶資源

已新增欄位「phone_verification_status」的 Accounts.BusinessInformation 專區。這是唯讀欄位，由 Accounts.VerifyPhoneNumber。

2021 年 9 月 13 日

BuyOnGooglePrograms 服務

BuyOnGoogleProgramStatus 資源

在 BuyOnGooglePrograms.BuyOnProgramStatus 資源改造：線上銷售通路、商業模式和客戶 服務電話。

新的 UpdateBuyOnGoogleProgramStatus 方法

新增了 UpdateBuyOnGoogleProgramStatus 方法，以便能夠更新。 已延長 BuyOnGooglePrograms.BuyOnProgramStatus 資源。

2021 年 9 月 6 日

帳戶服務

帳戶資源

已新增「korean_business_enroll_number」欄位的 Accounts.BusinessInformation 專區。只有在明確設為空字串時，系統才會清除這個欄位。

2021 年 8 月 30 日

促銷服務

新增具有「插入促銷活動」功能的全新促銷服務。

訂單服務

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

新訂單取消原因 FAILED_TO_CAPTURE_FUNDS

產品服務

產品資源

已將 productLength、productHeight、productWidth 和 productWeight 新增至 提供產品尺寸和重量。

2021 年 8 月 9 日

RepricingRule 服務

重新定價規則類型

RepricingRuleType 欄位的新列舉值。

已新增 TYPE_SALES_VOLUME_BASED 和 TYPE_COMPETITIVE_PRICE。

2021 年 5 月 17 日

訂單退貨標籤服務

已新增「product_id」] 欄位的值。商家可以指定 product_id 或 line_item_id 用於識別要傳回的商品。

產品服務

添加新方法，更新現有的 產品。您可以更新 提供要更新的產品，而不是提供要更新的欄位 整個產品

2021 年 5 月 3 日

訂單退貨標籤服務

新增上傳商家管理退貨 (MMR) 標籤的方法。使用 新orderreturns.labels.create，您可以上傳退貨單 在調查期間

2021 年 4 月 26 日

Shipping Settings API

以下位置新增「warehouseBasedDeliveryTimes」欄位： DeliveryTime ，以便協助運送服務根據下列資訊計算預估送達日期 取貨地點和所選貨運公司服務。

以下位置新增「eddServices」欄位： CarriersCarrier 物件，傳回可用於計算估計值的服務名稱 送達日期。

2021 年 4 月 12 日

產品服務

產品資源

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

運送欄位變更：已新增 minHandlingTime、maxHandlingTime。 由minTransitTime和maxTransitTime給ProductShipping提供優惠 等級的運送速度

2021 年 1 月 28 日

帳戶服務

已為 AccountLabel 和 Account 資源新增自動標籤支援。適用對象 詳情請參閱 CSS 標籤 types 部分 參閱 CSS 標籤管理指南

2020 年 10 月 5 日

CSSES 服務

CSS 資源

新增 csses 服務，用於擷取 CSS 網域和 標籤AccountLabel 資源現在也能用於 建立及列出 CSS 群組層級標籤詳情請參閱 CSS 供應商網站 標籤管理：

2020 年 8 月 24 日

產品服務

產品資源

新增「shoppingAdsExcludedCountries」欄位，即可從以下位置排除廣告： 特定國家/地區。

Productstatuses 資源

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

新的「itemLevelIssues.applicableCountries」欄位。

2020 年 8 月 10 日

帳戶服務

新增用於管理 Merchant Center 帳戶標籤的 AccountLabel 資源 這是 CSS 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 我的商家連結

您現在可以使用 Google 我的商家帳戶 ID：

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 方法：

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

移除 HTTP BATCH 方法

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

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

帳戶服務

更新

要求中的欄位 businessInformation 和 googleMyBusinessLink 。因此 防止商家意外刪除 這兩個欄位都包含 update (如果系統未提供的話)。

在第 2 版中，商家必須明確以空白的主體 ( {}) 提供這些欄位 加以刪除在 2.1 版中，如果您提供空白主體，或如有 即便您沒有提供這些資訊

帳戶資源

AdWords ->Google Ads 品牌重塑

AdWords 更名為 Google 廣告，下列 AdWords 相關欄位已重新命名：

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

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

Accountstatuses 服務

AccountStatus 資源

移除 data Quality 問題

已由 itemLevelIssues 取代。

Data 動態饋給服務

資料動態饋給資源

移除已淘汰的欄位

contentLanguage、targetCountry 和 intendedDestinations 欄位包含 已由 country、language、includedDestinations 和 targets 中的 excludedDestinations。

移除商品目錄更新內容

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

庫存服務

第 2 版 inventory 服務已移除，並由下列兩項新功能取代： v2.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 欄位格式已變更。

訂單付款服務

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

產品服務

insert 的回應只會包含以下屬性：

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

回應中不會再傳回不嚴重的警告和錯誤。這個 更能與動態饋給 規則和其他進階動態饋給規則 管理功能

現在起，插入產品需要延遲幾分鐘 由 get 或 list 擷取。

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

系統現在會先驗證價格，再插入產品。僅限下列字元 值字串：+、-、. 和數字 (0-9)。逗號是 不再接受。

產品資源

由遞迴 customAttributes 取代的 CustomGroup

先前還可以新增自訂屬性，將自訂屬性歸為一組 。自訂屬性現已推出 所以不需要自訂群組。

除了groupValues 原始 value 欄位；則必須設定其中一個參數，也就是說無法 請同時安排或退出

商家可能在 v2 和 v2.1 之間切換，因此產品 遞迴自訂屬性，無法在 v2 中以自訂群組的形式呈現 最多有兩個層級在這種情況下，自訂屬性群組會是 遭截斷。

移除 customAttributes 中的類型和單位

在 2.1 版中，自訂屬性不再包含 type 和 unit。 單位必須附加至 value (如有)，類型則應 自動偵測。如果是測驗考試，請使用「1.23 EUR」或「5.6 公分」作為 value 。

ProductType 取代了 productType 和 additionalProductType

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

以 includeDestinations 和 excludedDestinations 取代的目的地屬性

在第 2 版中，目的地是以清單形式輸入目的地名稱和意圖組合 。destinations。這個欄位已由 將納入兩個重複欄位：includedDestinations 和 excludedDestinations。系統預設啟用的到達網頁不需要 includedDestinations. 這與目的地設定相符 覆寫值

AdWords 更名為 Google 廣告，下列 AdWords 相關欄位已重新命名：

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

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

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

產品狀態服務

取得並列出

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

清單

已移除參數 includeInvalidInsertedItems。所有產品都是 現在不論這些是否有效，都會傳回；也就是說，list 現在的行為將視為 如果 includeInvalidInsertedItems 一律設為 true。

ProductStatus 資源

DestinationsStatuses

以下欄位中的欄位 intention、approvalStatus 和 approvalPending destinationStatuses 已由 status 取代，這個字串可以 可以是 approved、disapproved 或 pending 其中之一。

移除 data Quality 問題

已由 itemLevelIssues 取代。