2024 年 8 月 26 日(比最初通知时间快)
订单相关服务
在与订单相关的 API 关停期间,我们已弃用以下服务:
- orderinvoices
- orderreports
- orderreturns
- orderreturns.labels
- orders
对上述服务的调用预计会失败并返回 Service was not found on the server
响应。
OrderTrackingSignals
服务未弃用,仍可继续使用。
2024 年 8 月 10 日
Google 易购服务
关停 Google 易购 API 期间,BuyOnGoogleProgramService
中的所有方法都将失败并显示 service was not found on the server
。
2024 年 7 月 19 日
产品服务
添加了 member_price_effective_date
字段。如果适用,您可以通过此更新指定会员回馈活动
会员价有效。如果未提供此字段值,则会员价格始终为
。
2024 年 5 月 20 日
产品服务
添加了 LoyaltyPrograms
。通过此次更新,您可以为同一商品提供多个层级,分别提供不同的积分、价格等。
您应使用此字段代替单数 LoyaltyProgram
字段。
Reports 服务
弃用了 Google 易购指标
MerchantPerformanceView
表格。完成此更新后,检索任何 Google 易购指标都会返回 0。这个
也适用于过去日期的历史值。
如需了解详情,请参阅弃用“在 Google 上购买”。
2024 年 5 月 13 日
产品服务
产品资源
对认证字段的更改:已添加
certificationValue
添加到
ProductCertification
字段提供认证值(也称为“class”、“level”或“Grade”),
这让用户可以将
认证信息
即使认证授权机构不颁发认证代码或编号,也是如此。
如需更多信息,请参阅我们的 商品指南。
2024 年 5 月 6 日
Reports 服务
向 PriceInsightsProductView
表添加了有效性分桶。
有效性可指明哪些商品将从价格变动中受益最多。此评分会考虑调整促销价以及当前价格与建议价格之间的差值预计会提升的效果。
2024 年 4 月 24 日
产品服务
产品资源
为分期付款添加了可选 downpayment
和 creditType
字段:
downpayment
提供买家需要预付的一次性付款金额。creditType
提供分期付款的类型(finance
或lease
)。此字段仅适用于车辆广告。
2024 年 4 月 11 日
产品服务
产品资源
- 为商品级运费添加了免运费门槛属性 (
FreeShippingThreshold
)。通过此属性,商家可以输入使运费变为免费的最低商品价格。 - 更改了
LoyaltyPoints
的公开范围
2024 年 4 月 10 日
产品服务
产品资源
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 日
Google 搜索和 Google 购物将停用 Google 易购。您可以继续查看
2024 年 10 月 31 日之前使用
orders.list
和
orders.get
。
2024 年 3 月 8 日
Reports 服务
向 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) 服务
为以下中的 matching_status_hint
字段添加了新值:
PosStore、
这样一来,用户就可以详细了解为何他们的商店匹配
已失败。
2024 年 1 月 11 日
Accounts 服务
添加了 localProductManager
和 localProductManagement
作为链接类型,
link
方法。以便账号关联
以管理本地商品数据
2023 年 11 月 29 日
商家支持服务
为身份添加了 VERIFY_IDENTITY_IN_MERCHANT_CENTER
外部操作类型
需要在 Merchant Center 中执行。
销售终端 (POS) 服务
向以下项目添加了 matching_status
和 matching_status_hint
字段:
PosStore
让用户了解 Pos 商店与 Google 商家的匹配状态
个人资料存储,并在出现问题时提示修复问题。
2023 年 11 月 15 日
repricingrules
和 repricingrules.repricingreports
端点不再
支持。
2023 年 11 月 1 日
配送设置服务
不再支持 shipment_type=pickup
。
2023 年 10 月 18 日
Accounts 服务
新增了 Business Identity
字段,可让商家自行标识
特定的消费者价值。
2023 年 10 月 10 日
将Collection Point
添加为配送设置服务的新配送类型。答
取件点送达服务是由第三方(例如 Google Ads)
将商品配送到第三方关联地点(例如
UPS Access Points),而不是直接送货上门。
2023 年 9 月 18 日
LIA 设置服务
添加了 setOmnichannelExperience
方法,允许用户设置其全渠道
体验(即本地店面页面和自提设置)。届时,
仅适用于其 POS 提供商可信可启用此类服务的用户
设置。
2023 年 9 月 7 日
弃用“在 Google 上购买”
将新的 DEPRECATED
状态添加到 GetBuyOnGoogleProgramStastus
方法中。
无法将节目从此类状态重新激活或暂停。
2023 年 9 月 4 日
商家支持服务
针对需要解决的商品问题添加了 FIX_ACCOUNT_ISSUE
内置操作
已在账号级别解决添加了 SHOW_ADDITIONAL_CONTENT
内置操作
该要求将用于向国家机构提供正当理由。
2023 年 8 月 28 日
促销服务
在 Promotions
服务中打开 list
方法,对全部服务具有有限访问权限。
2023 年 8 月 22 日
商家支持服务
推出了商家支持服务。此服务为以下各项提供支持内容: 账号问题和产品问题。
2023 年 8 月 4 日
Reports 服务
向报告服务中添加了“关闭竞争对手的竞争洞察”报告。
有关详情,请参阅我们的报告 指南。
2023 年 7 月 25 日
销售终端 (POS) 服务
房源/票源资源
添加了 pickup_method
和 pickup_sla
字段,以便为商家提供相关功能
提交自提信息以及商品目录。
2023 年 7 月 14 日
Reports 服务
向报告服务中添加了竞争洞察报告。
有关详情,请参阅我们的报告 指南。
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 日
配送设置服务
商店代码验证
系统现在会对商店代码进行验证,以确保它们之前属于商家 运费设置已更新。
LIA 商家验证
现在,在设置配送设置之前,商家 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 日
Reports 服务
向报告服务添加了市场洞察报告。
现在,您可以通过报告服务查询以下内容:
- 畅销商品报告
使用
BestSellersProductClusterView
和BestSellersBrandView
表。 - 价格竞争力报告
使用
PriceCompetitivenessProductView
表。 - 价格分析报告
使用
PriceInsightsProductView
表。
有关详情,请参阅我们的报告 指南。
2022 年 11 月 7 日
Datafeeds 服务
为 Datafeeds 服务添加了 feedLabel
支持。
2022 年 9 月 14 日
更新时间
feedLabel
可接受任何字符串。
2022 年 8 月 9 日
已添加
feedLabel
。
你现在可以使用 feedLabel
,而不是
targetCountry
用于指定优惠 ID 的国家/地区。优惠 ID 现在的构建方式为
online:language:feedLabel:offerId
。
已使用 targetCountry
的值自动填充 feedLabel
现有 Feed 以实现向后兼容性。
废弃了 targetCountry
。
为了支持全球性优惠,Content API for Shopping 已弃用
targetCountry
字段。相反,我们建议使用
shipping
字段以指定您的目标国家/地区。
targetCountry
现在会自动填入您在
feedLabel
。
请参阅博文 Feed label replace target country in Content API for 购物 了解详情。
2021 年 12 月 8 日
账号服务
账号资源
已添加新章节 Account.AutomaticImprovements (位于 Accounts 资源中)。
通过这个新部分,商家可以自动更新商品、改进 图片和运费设置
2021 年 10 月 25 日
促销服务
向 Promotion API 添加 Get Promotion。
2021 年 10 月 11 日
Shipping Settings API
在 ShippingSettings 中新增了 warehouse
字段
资源
让商家可以管理用来订单商品的仓库
WarehouseBasedDeliveryTime.
在以下位置添加新的“warehouseName
”字段:
WarehouseBasedDeliveryTime
用于指代
仓库,作者
仓库名称
2021 年 10 月 4 日
账号服务
账号资源
添加了新字段“phone_verification_status”在 Accounts.BusinessInformation 部分。此字段是只读字段,由 Accounts.VerifyPhoneNumber。
2021 年 9 月 13 日
Google 易购计划服务
BuyOnGoogleProgramStatus 资源
在 BuyOnGooglePrograms.BuyOnProgramStatus 资源介绍:在线销售渠道、业务模式和客户 服务电话。
新增了 UpdateBuyOnGoogleProgramStatus 方法
添加了新的 UpdateBuyOnGoogleProgramStatus 方法,该方法允许更新 延长 BuyOnGooglePrograms.BuyOnProgramStatus 资源。
2021 年 9 月 6 日
账号服务
账号资源
已添加新字段“korean_business_registration_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 标签
类型部分,
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 日
账号服务
添加了新的 AccountLabel
资源,用于管理 Merchant Center 账号标签
适用于 CSS CenterCSS 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 日
Orderreturns 服务
新增了 acknowledge
和 process
方法,并为
读取方法(list
、get
)。
GMB 关联
添加了使用 “Google 我的商家”账号 ID。
2020 年 4 月 14 日
结算报告 API
添加了用于获取结算的新服务 报告。
2020 年 3 月 9 日
Local Inventory API
添加了用于提交本地商品目录数据的新服务。
2020 年 3 月 2 日
Pubsub 通知设置 API
添加了一项新服务,用于管理 pubsub 的设置 通知。
2019 年 12 月 3 日
产品服务
新增了对多客户账号补充 Content API Feed 的支持。
2019 年 9 月 11 日
订单服务
添加了对订单中的自取货品和相应的沙盒功能的支持。
2019 年 8 月 14 日
新的服务
针对“在 Google 上购买”新增了退货政策和退货地址服务。
订单服务
订单资源
新字段
新的 quantityUndeliverable
字段。
2019 年 8 月 7 日
订单服务
订单资源
新字段
向订单资源添加了新的 loyaltyInfo
和 invoiceReceivingEmail
字段。
2019 年 7 月 1 日
产品服务
支持在产品服务中添加补充 Content API Feed。
2019 年 6 月 11 日
订单服务
Order 和 TestOrder 资源
添加价格调整项
新增了 lineItem[].adjustments
字段,其中包含对原始值的调整
因使用促销优惠而产生的订单项价格和税费。
2019 年 2 月 14 日
此版本中引入的更改
不再支持试运行
参数 dryRun
已从 v2.1 中移除。这适用于所有 API
调用。
不再支持 Patch 方法
以下服务不再支持 patch
方法:
- 账号
- 账号税费
- 数据 Feed
- 利亚设置
- 配送设置
移除 HTTP BATCH 方法
v2.1 中移除了所有 HTTP BATCH
方法,请改用 customBatch
。
受影响的服务如下:
- 账号
- 账号状态
- 数据 Feed
- Datafeedstatuses
- 利亚设置
- 订单报告
- 排名
- 产品
- 商品状态
- 配送设置
账号服务
更新
该请求中的字段 businessInformation
和 googleMyBusinessLink
是
在 Content API v2 首次推出后引入。因此,
一种保护措施,可防止商家意外删除
如果未提供这两个字段,则使用 update
。
在 v2 中,商家必须为这些字段明确提供空的正文 ( {}
)
删除它们。在 v2.1 中,如果提供空正文,或者如果
您并未提供。
账号资源
AdWords ->Google Ads 品牌更名
随着 AdWords 更名为 Google Ads, 与 AdWords 相关的字段已重命名:
adwordsLinks
->adsLinks
adwordsLinks.adwordsId
->adsLinks.adsId
移除已弃用的字段和值
已弃用的字段 reviewsUrl
已被移除。此外,关联状态
inactive
已删除对 adsLinks
、googleMyBusinessLink
和
youtubeChannelLinks
。
Accountstatuses 服务
AccountStatus 资源
移除 dataQualityIssues
这些已被itemLevelIssues
取代。
Datafeed 服务
Datafeed 资源
移除了已弃用的字段
contentLanguage
、targetCountry
和 intendedDestinations
字段的
已移除并替换为 country
、language
、includedDestinations
和
targets
中的 excludedDestinations
。
移除商品目录更新
“product inventory update
”类型的 Feed 已被移除。
房源/票源服务
v2 inventory
服务已被移除并由以下两项新功能取代:
v2.1:
- 使用新的补充 Feed 部分商品更新。
- 使用新的
localinventory
用于本地商品更新。
订单服务
CancelLineItem
请求中的字段 amount
、amountPretax
和 amountTax
已移除。现在系统会自动计算退款金额。
CustomBatch
v2.1 中移除了 CustomBatch
。
InStoreRefundLineItem
amountPretax
和 amountTax
字段已替换为 priceAmount
和 taxAmount
。字段 priceAmount
可以是税前值或
税后金额。
退款
此方法已被移除。请改用 returnRefundLineItem
。
ReturnLineItem
此方法已被移除。使用 returnRefundLineItem
而不提供
退款金额。
ReturnRefundLineItem
amountPretax
和 amountTax
字段已替换为 priceAmount
和 taxAmount
。字段 priceAmount
可以是税前值或
税后金额。
ShipLineItem
请求中的字段 carrier
、shipmentId
和 trackingId
已移至 shipmentInfos
。
Order 和 TestOrder 资源
新的促销格式
v2.1 中提供了一种新的促销格式。您无法使用广告素材创建测试订单 促销。
移除了已弃用的字段
字段 paymentMethod
已被移除,并且 billingAddress
和 predefinedBillingAddress
现在是 Order
和
TestOrder
。
此外,customer.explicitMarketingPreference
已被移除,
在 Order
和 TestOrder
中均替换为 customer.marketingRightsInfo
。
已弃用的字段 customer.email
已被移除。
Order
资源中的 promotions
字段格式已更改。
Orderpayments 服务
v2.1 中移除了此服务。
产品服务
来自 insert
的响应将仅包含以下属性:
channel
contentLanguage
id
offerId
targetCountry
响应中不再返回非严重警告和错误。这个 可更好地与 Feed 集成 规则和其他高级 Feed 管理功能
现在,您插入的商品会有几分钟的延迟
由 get
或 list
检索。
不再保证返回的优惠 ID 与输入的优惠相同 ID。
现在,价格会在商品插入前验证。只有以下字符
值字符串中允许使用以下字符:+
、-
、.
和数字 (0
-9
)。英文逗号是
。
产品资源
CustomGroup 已替换为递归 customAttributes
以前,您可以通过添加自定义属性 属性。自定义属性现在 在 v2.1 中是递归的,因此无需自定义群组。
除了groupValues
原始 value
字段;必须设置其中一个,这意味着不能
可同时设置还是省略。
由于商家可能会在 v2 和 v2.1 之间切换,因此商品 递归自定义属性,这些属性在 v2 中不能表示为自定义组 最多可以设置两个级别在本例中,自定义属性组将是 被截断。
移除了 customAttributes 中的类型和单位
在 v2.1 中,自定义属性不再包含 type
和 unit
,相反,
单位将附加到 value
(如果存在),类型应为
。例如,使用“1.23 EUR”或“5.6 厘米”以value
的身份
。
ProductTypes 取代 productType 和 additionalProductTypes
以前,产品类型存储在两个字段中,第一个类型位于
奇异字段 productType
,重复字段中的剩余部分
additionalProductTypes
。在 v2.1 中,这两个字段已替换为单个
重复字段 productTypes
。
Destinations 属性已替换为 includeDestinations 和 excludedDestinations
在 v2 中,输入的 Destinations 是“Destination name”和“intent for”对的列表
重复字段 destinations
中的值。该字段已被
以下两个重复的字段:includedDestinations
和
excludedDestinations
。默认启用的目标平台无需包含在
includedDestinations.
这将与目标位置的配置一致
替换值。
与 AdWords 相关的字段更名
随着 AdWords 更名为 Google Ads, 与 AdWords 相关的字段已重命名:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
移除了已弃用的字段
移除了以下已弃用的字段:
aspects
destinations
onlineOnly
validatedDestinations
warnings
Productstatuses 服务
获取和列出
移除了 product
属性以及 includeAttributes
参数。要检索与状态对应的商品属性,请使用
Products
服务以及新 productId
字段的值。
列表
参数 includeInvalidInsertedItems
已被移除。所有产品均为
现在都返回,无论它们是否有效,这意味着 list
现在的行为类似于
如果 includeInvalidInsertedItems
始终设置为 true
。
ProductStatus 资源
DestinationsStatuses
intention
、approvalStatus
和 approvalPending
中的
destinationStatuses
已替换为 status
,后者是一个字符串,
为 approved
、disapproved
或 pending
中的一个。
移除 dataQualityIssues
这些已被itemLevelIssues
取代。