版本資訊 (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 日

產品服務

產品資源

已為「分期付款」新增 downpaymentcreditType 選用欄位:

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

2024 年 4 月 11 日

產品服務

產品資源

  • 已新增商品層級運送的免運費門檻屬性 (FreeShippingThreshold)。這項屬性可讓商家輸入最低產品價格,才能免費使用運費。
  • 已變更 LoyaltyPoints 的顯示設定

2024 年 4 月 10 日

產品服務

產品資源

已新增「LoyaltyProgram

2024 年 4 月 9 日

產品服務

產品資源

已新增 structuredTitlestructuredDescription,提供 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.listorders.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 日

帳戶服務

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

2023 年 11 月 29 日

商家支援服務

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

銷售點 (POS) 服務

已將 matching_statusmatching_status_hint 欄位新增至 PosStore 方便使用者瞭解 Pos Store 與 Google 商家的比對狀態 儲存資料,以及在發生問題時修正的提示。

2023 年 11 月 15 日

repricingrulesrepricingrules.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.ConversionSettingsAccounts 資源中。

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.AutomaticImprovementsAccounts 資源中。

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

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

產品服務

產品資源

已將 productLengthproductHeightproductWidthproductWeight 新增至 提供產品尺寸和重量。

2021 年 8 月 9 日

RepricingRule 服務

重新定價規則類型

RepricingRuleType 欄位的新列舉值。

已新增 TYPE_SALES_VOLUME_BASEDTYPE_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 種尺寸類型。

運送欄位變更:已新增 minHandlingTimemaxHandlingTime。 由minTransitTimemaxTransitTimeProductShipping提供優惠 等級的運送速度

2021 年 1 月 28 日

帳戶服務

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

2020 年 10 月 5 日

CSSES 服務

CSS 資源

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

2020 年 8 月 24 日

產品服務

產品資源

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

Productstatuses 資源

新增 approvedCountriespendingCountriesdisapprovedCountries 欄位: destinationStatuses 物件,可提供優惠狀態資訊以外的 targetCountry

新的「itemLevelIssues.applicableCountries」欄位。

2020 年 8 月 10 日

帳戶服務

新增用於管理 Merchant Center 帳戶標籤的 AccountLabel 資源 這是 CSS Center 的重要工具CSS Center 使用者現在也能列出自己的 Merchant Center 帳戶 帳戶,並使用下列 accounts.listaccounts.getaccounts.updatelabels 方法。詳情請參閱 CSS 標籤 管理

2020 年 6 月 19 日

產品服務

產品資源

新欄位

新增productDetailsproductHighlightssubscriptionCostcanonicalLink 欄位。

2020 年 6 月 2 日

訂單服務

新增不需退貨即可申請退款的新方法。使用新的 orders.refunditemorders.refundorder,您可以就訂單辦理退款 即使沒有退回客戶也一樣。

2020 年 4 月 27 日

訂單退貨服務

新增了 acknowledgeprocess 方法,以及 讀取方法 (listget)。

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 日

訂單服務

排序資源

新欄位

已將新的 loyaltyInfoinvoiceReceivingEmail 欄位新增至「訂單」資源。

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
  • 利亞設定
  • 訂單報表
  • 排名
  • 產品
  • 產品狀態
  • 運送設定

帳戶服務

更新

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

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

帳戶資源

AdWords ->Google Ads 品牌重塑

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

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

已移除淘汰的欄位「reviewsUrl」。此外,連結狀態 inactive 已移除 adsLinksgoogleMyBusinessLinkyoutubeChannelLinks

Accountstatuses 服務

AccountStatus 資源

移除 data Quality 問題

已由 itemLevelIssues 取代。

Data 動態饋給服務

資料動態饋給資源

移除已淘汰的欄位

contentLanguagetargetCountryintendedDestinations 欄位包含 已由 countrylanguageincludedDestinationstargets 中的 excludedDestinations

移除商品目錄更新內容

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

庫存服務

第 2 版 inventory 服務已移除,並由下列兩項新功能取代: v2.1:

訂單服務

CancelLineItem

要求中的欄位 amountamountPretaxamountTax 已移除退款金額現在會自動計算。

CustomBatch

CustomBatch 已從 2.1 版中移除。

InStoreRefundLineItem

amountPretaxamountTax 欄位已由 priceAmount 取代 和 taxAmountpriceAmount 欄位可能包含稅前金額或 稅後金額,視訂單地點而定。

退款

這個方法已移除。請改用 returnRefundLineItem

ReturnLineItem

這個方法已移除。使用 returnRefundLineItem,但不提供 退款金額。

ReturnRefundLineItem

amountPretaxamountTax 欄位已由 priceAmount 取代 和 taxAmountpriceAmount 欄位可能包含稅前金額或 稅後金額,視訂單地點而定。

ShipLineItem

要求中的欄位 carriershipmentIdtrackingId 已移至 shipmentInfos

訂單和 TestOrder 資源

新的促銷活動格式

v2.1 提供全新的促銷活動格式。您無法透過 促銷活動。

移除已淘汰的欄位

paymentMethod 欄位已移除,且 billingAddresspredefinedBillingAddress 現在是 OrderTestOrder

此外,customer.explicitMarketingPreference 已遭移除, 在 OrderTestOrder 中都替換為 customer.marketingRightsInfo

已移除淘汰的欄位「customer.email」。

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

訂單付款服務

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

產品服務

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

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

現在起,插入產品需要延遲幾分鐘 由 getlist 擷取。

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

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

產品資源

由遞迴 customAttributes 取代的 CustomGroup

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

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

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

移除 customAttributes 中的類型和單位

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

ProductType 取代了 productType 和 additionalProductType

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

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

在第 2 版中,目的地是以清單形式輸入目的地名稱和意圖組合 。destinations。這個欄位已由 將納入兩個重複欄位:includedDestinationsexcludedDestinations。系統預設啟用的到達網頁不需要 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

以下欄位中的欄位 intentionapprovalStatusapprovalPending destinationStatuses 已由 status 取代,這個字串可以 可以是 approveddisapprovedpending 其中之一。

移除 data Quality 問題

已由 itemLevelIssues 取代。