版本資訊 (v2.1)

2024 年 10 月 30 日

在結算相關 API 關閉的過程中,我們已淘汰下列服務: - settlementreports - settlementtranscations

結算相關 API 的關閉作業與先前關閉的 BuyOnGoogle 計畫和訂單相關 API 有關。

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

2024 年 10 月 16 日

UpdateConversionSourceRequest 中的 update_mask 現已改名為 OPTIONAL。如果未指定更新遮罩,系統會更新所有非空值的欄位。

2024 年 8 月 26 日 (比原先通知的時間提早)

為配合Orders 相關 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 欄位。

報表服務

MerchantPerformanceView 表格中已淘汰的 Buy on Google 指標。更新之後,如果您擷取任何 Buy on Google 指標,系統將傳回 0。這也適用於過去日期的歷來值。

詳情請參閱「Buy on Google 淘汰計劃」。

2024 年 5 月 13 日

產品服務

產品資源

認證欄位變更:新增 ProductCertification 欄位的 certificationValue,提供認證值 (又稱為類別、等級或等級),讓使用者即使認證機構未發出認證號碼或編號,也能上傳認證資訊

詳情請參閱產品指南

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 搜尋和購物服務。您可以使用 orders.listorders.get,在 2024 年 10 月 31 日前繼續查看現有訂單。

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 天做為有效選項。

2024 年 1 月 17 日

銷售點 (POS) 服務

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

2024 年 1 月 11 日

帳戶服務

已分別將 localProductManagerlocalProductManagement 新增為 link 方法的連結類型和服務。這類連結可讓帳戶進行連結,以便管理店面產品資料。

2023 年 11 月 29 日

商家支援服務

已新增 VERIFY_IDENTITY_IN_MERCHANT_CENTER 外部動作類型,用於驗證身分。這項動作需要在 Merchant Center 中執行。

銷售點 (POS) 服務

PosStore 中新增 matching_statusmatching_status_hint 欄位,讓使用者瞭解 PosStore 與 Google 商家檔案商店的配對狀態,並在發生問題時提供修正提示。

2023 年 11 月 15 日

不再支援 repricingrulesrepricingrules.repricingreports 端點。

2023 年 11 月 1 日

運送設定服務

系統已不再支援 shipment_type=pickup

2023 年 10 月 18 日

帳戶服務

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

2023 年 10 月 10 日

新增 Collection Point 做為運送設定服務的新運送類型。取貨地點遞送服務是由第三方 (例如非商家擁有) 提供的服務,將商品運送至第三方關聯地點 (例如 UPS Access Points),而非直接運送至住家。

2023 年 9 月 18 日

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

新增 setOmnichannelExperience 方法,可讓使用者設定全通路體驗 (即本地店面和取貨設定)。目前,只有 POS 供應商已獲信任的使用者,才能啟用這類設定。

2023 年 9 月 7 日

Buy on Google 淘汰

將新的 DEPRECATED 狀態新增至 GetBuyOnGoogleProgramStastus 方法。無法重新啟用或暫停計畫。

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_methodpickup_sla 欄位,讓商家能夠一併提交自家商品目錄和自取資訊。

2023 年 7 月 14 日

報表服務

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

詳情請參閱報表指南

2023 年 7 月 7 日

產品服務

產品資源

新增 virtualModelLink,提供 3D 模型圖片的網址。

2023 年 7 月 4 日

產品服務

產品資源

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

2023 年 6 月 26 日

運送設定服務

本機履行

新增 no_delivery_post_cutoff 欄位,讓商家如果將運送服務設為「當地到貨 n 日」時,可以選擇不顯示 1 天以上的當地到貨服務。

2023 年 5 月 29 日

宣傳活動服務

已為 Promotions 服務新增 list 方法。

推薦服務

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

2023 年 5 月 9 日

Cloud Retail 目的地

Cloud Retail 額外屬性

新增雲端零售業額外屬性欄位。這是重複欄位,可供使用 Cloud Retail 目的地的客戶使用。使用這個欄位時,系統會在使用雲端零售方案時提供此欄位。這會對應至 Google Cloud Retail 產品模型中的屬性欄位。

2023 年 5 月 22 日

宣傳活動服務

Promotions 服務新增 list 方法。

2023 年 4 月 11 日

運送設定服務

本機履行

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

4 月 3 日

推薦服務

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

2023 年 2 月 20 日

帳戶服務

帳戶資源

Accounts 資源中新增 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 部分新增了「promotionStatus」欄位。這是唯讀欄位。

2022 年 11 月 15 日

報表服務

在報表服務中新增市場洞察報表。

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

詳情請參閱製作報表指南

2022 年 11 月 7 日

資料動態饋給服務

新增對 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 日

帳戶服務

帳戶資源

在「Accounts」資源中新增「Account.AutomaticImprovements」一節。

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

2021 年 10 月 25 日

宣傳服務

將 Get Promotion 新增至 Promotion API。

2021 年 10 月 11 日

Shipping Settings API

ShippingSettings 資源中新增 warehouse 欄位,方便商家管理可用於 WarehouseBasedDeliveryTime 的倉庫。

WarehouseBasedDeliveryTime 中新增 warehouseName 欄位,以倉庫名稱參照倉庫

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

產品服務

產品資源

新增 productLengthproductHeightproductWidthproductWeight,以提供產品尺寸和重量。

2021 年 8 月 9 日

RepricingRule 服務

RepricingRule 類型

RepricingRuleType 欄位的新增列舉值。

新增 TYPE_SALES_VOLUME_BASEDTYPE_COMPETITIVE_PRICE

2021 年 5 月 17 日

訂單退貨標籤服務

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

產品服務

新增方法來更新現有產品。如要更新產品,請只提供需要更新的欄位,而非整個產品。

2021 年 5 月 3 日

訂單退貨標籤服務

新增上傳商家管理退貨 (MMR) 標籤的新方法。透過新的 orderreturns.labels.create,你可以上傳退貨標籤,並與客戶分享。

2021 年 4 月 26 日

Shipping Settings API

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

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

2021 年 4 月 12 日

產品服務

產品資源

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

運送欄位的變更:在 ProductShipping 中新增 minHandlingTimemaxHandlingTimeminTransitTimemaxTransitTime,以便提供商品層級的運送速度。

2021 年 1 月 28 日

帳戶服務

AccountLabelAccount 資源新增自動標籤支援功能。詳情請參閱「CSS 標籤管理指南」中的「CSS 標籤類型」一節。

2020 年 10 月 5 日

CSSES 服務

CSS 資源

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

2020 年 8 月 24 日

產品服務

產品資源

新增 shoppingAdsExcludedCountries 欄位,可排除在特定國家/地區放送的商品。

Productstatuses 資源

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

新的「itemLevelIssues.applicableCountries」欄位。

2020 年 8 月 10 日

帳戶服務

新增 AccountLabel 資源,用於管理 CSS Center 的 Merchant Center 帳戶標籤。CSS Center 使用者現在也可以使用 accounts.listaccounts.getaccounts.updatelabels 方法,列出 Merchant Center 帳戶並指派標籤。詳情請參閱「CSS 標籤管理」一文。

2020 年 6 月 19 日

產品服務

產品資源

新欄位

新的 productDetailsproductHighlightssubscriptionCostcanonicalLink 欄位。

2020 年 6 月 2 日

訂單服務

新增啟動退款但不退貨的新方法。有了新的 orders.refunditemorders.refundorder,即使消費者未退回商品,您也可以針對訂單辦理退款。

2020 年 4 月 27 日

退貨服務

新增方法 acknowledgeprocess,以及讀取方法 (listget) 的新篩選器和欄位。

Google 我的商家連結

新增使用 Google 我的商家帳戶 ID 將 Merchant Center 帳戶連結至 Google 我的商家帳戶的功能。

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 日

訂單服務

排序資源

新欄位

在 Order 資源中新增 loyaltyInfoinvoiceReceivingEmail 欄位。

2019 年 7 月 1 日

產品服務

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

2019 年 6 月 11 日

訂單服務

Order 和 TestOrder 資源

新增價格調整

新增 lineItem[].adjustments 欄位,其中包含因套用促銷活動而對原項目價格和稅金所做的調整。

2019 年 2 月 14 日

此版本的變更

不再支援模擬測試

參數 dryRun 已從 v2.1 中移除。這適用於所有 API 呼叫。

不再支援修補程式方法

以下服務已不再支援 patch 方法:

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

移除 HTTP BATCH 方法

所有 HTTP BATCH 方法都已從 v2.1 中移除。請改用 customBatch。受影響的服務如下:

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

帳戶服務

更新

在 Content API 2 版初次推出後,要求中的 businessInformationgoogleMyBusinessLink 欄位才會出現。因此,我們設有安全防護機制,避免商家在未提供這兩個欄位資訊的情況下,不小心刪除這些欄位中的資訊。update

在 v2 中,商家必須明確提供這些欄位具有空白主體 ( {}),才能刪除這些欄位。在 v2.1 中,如果您提供空白的內容或未提供內容,系統會刪除欄位。

帳戶資源

AdWords -> Google Ads 品牌重塑

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

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

已淘汰的欄位 reviewsUrl 已移除。此外,inactiveadsLinksgoogleMyBusinessLinkyoutubeChannelLinks 的連結狀態已經移除。

Accountstatuses 服務

AccountStatus 資源

移除資料品質問題

這些已由 itemLevelIssues 取代。

資料動態饋給服務

資料動態饋給資源

移除已淘汰的欄位

contentLanguagetargetCountryintendedDestinations 欄位已移除,並在 targets 中替換為 countrylanguageincludedDestinationsexcludedDestinations

移除產品目錄更新

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

庫存服務

v2 inventory 服務已在 v2.1 中移除,並由兩項新功能取代:

訂單服務

CancelLineItem

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

CustomBatch

CustomBatch 已從 v2.1 中移除。

InStoreRefundLineItem

amountPretaxamountTax 欄位已分別由 priceAmounttaxAmount 取代。priceAmount 欄位的值可能會是稅前或稅後金額,視訂單所在地而定。

退款

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

ReturnLineItem

這個方法已遭移除。請改用 returnRefundLineItem,但不要提供退款金額。

ReturnRefundLineItem

amountPretaxamountTax 欄位已分別由 priceAmounttaxAmount 取代。視訂單地點而定,priceAmount 欄位可能是稅前金額或稅後金額。

ShipLineItem

要求中的 carriershipmentIdtrackingId 欄位已移至 shipmentInfos

Order 和 TestOrder 資源

新增促銷活動格式

在 2.1 版中,我們新增了促銷活動格式。您無法建立含有促銷活動的測試訂單。

移除已淘汰的欄位

paymentMethod 欄位已移除,billingAddresspredefinedBillingAddress 分別是 OrderTestOrder 中的頂層欄位。

此外,customer.explicitMarketingPreference 已在 OrderTestOrder 中移除,並由 customer.marketingRightsInfo 取代。

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

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

Orderpayments 服務

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

產品服務

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

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

回應中不再傳回非致命警告和錯誤。與動態饋給規則和其他進階動態饋給管理功能更緊密地整合。

目前,系統需要幾分鐘的時間,才能透過 getlist 擷取插入的產品。

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

價格現在會在產品插入前進行驗證。值字串中僅允許使用以下字元:+-. 和數字 (0-9)。系統不再接受逗號。

產品資源

CustomGroups 已由遞迴 customAttributes 取代

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

自訂屬性現在除了原有的 value 欄位外,還多了 groupValues 欄位;必須設定其中一個,也就是說無法同時設定或略過。

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

移除 customAttributes 中的類型和單位

在 v2.1 中,自訂屬性將不再包含 typeunit。相反地,單位應附加至 value (如有),系統應自動偵測類型。例如,在 v2.1 中使用「1.23 EUR」或「5.6 cm」做為 value

ProductTypes 取代 productType 和 additionalProductTypes

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

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

在 v2 中,目的地是以重複欄位 destinations 中的目的地名稱和意圖組成的清單輸入。這個欄位已由下列兩個重複欄位取代:includedDestinationsexcludedDestinations。系統預設啟用的目的地不需要包含在 includedDestinations. 中。這與動態饋給中的目的地覆寫設定相符。

隨著 AdWords 改為 Google Ads,下列 AdWords 相關欄位已重新命名:

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

下列已淘汰的欄位已遭移除:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

產品狀態服務

取得和清單

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

清單

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

ProductStatus 資源

DestinationsStatuses

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

移除 data Quality 問題

這些已由 itemLevelIssues 取代。