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 日
報表服務
將「市場洞察」報表新增至報表服務。
您現在可以查詢報表服務執行下列作業:
- 暢銷商品報表
使用
BestSellersProductClusterView
和BestSellersBrandView
資料表。 - 價格競爭力報表
使用
PriceCompetitivenessProductView
資料表。 - 價格分析報表
使用
PriceInsightsProductView
資料表。
詳情請參閱報告 指南。
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 相關欄位已重新命名:
adwordsLinks
->adsLinks
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:
- 使用新的補充動態饋給 。
- 使用新版
localinventory
提供店面產品更新服務
訂單服務
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 相關欄位重新命名
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
取代。