2024 年 5 月 20 日
产品服务
添加了 LoyaltyPrograms
。此更新可让您为单件商品提供具有不同积分、价格等的多个层级。
您应使用此字段来代替单数 LoyaltyProgram
字段。
报告服务
废弃了 MerchantPerformanceView
表中的“在 Google 上购买”指标。完成此更新后,检索任何 Google 易购指标都会返回 0。这同样适用于过去日期的历史值。
如需了解详情,请参阅弃用 Google 易购。
2024 年 5 月 13 日
产品服务
商品资源
对认证字段的更改:向 ProductCertification 字段添加了 certificationValue
以提供认证值(也称为等级、等级或等级),这样一来,即使认证机构没有颁发认证代码或认证编号,用户也可以上传认证信息。
如需了解详情,请参阅我们的产品指南。
2024 年 5 月 6 日
报告服务
向 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
服务添加了 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) 服务
为 PosStore 中的 matching_status_hint
字段添加了新值,让用户可以详细了解其商店匹配失败的原因。
2024 年 1 月 11 日
Accounts 服务
为 link
方法分别添加了 localProductManager
和 localProductManagement
作为链接类型和服务。这样,帐号关联后,您就可以管理本地商品数据了。
2023 年 11 月 29 日
商家支持服务
为需要在 Merchant Center 中执行的身份验证添加了 VERIFY_IDENTITY_IN_MERCHANT_CENTER
外部操作类型。
销售终端 (POS) 服务
向 PosStore 添加了 matching_status
和 matching_status_hint
字段,让用户可以了解 Pos Store 与 Google 商家资料商店的匹配状态,并在出现问题时提示修复问题。
2023 年 11 月 15 日
不再支持 repricingrules
和 repricingrules.repricingreports
端点。
2023 年 11 月 1 日
配送设置服务
shipment_type=pickup
已不再受支持。
2023 年 10 月 18 日
Accounts 服务
添加了 Business Identity
字段,让商家可以基于特定的消费者价值进行自我识别。
2023 年 10 月 10 日
在配送设置服务中添加了“Collection Point
”作为新的配送类型。取件点配送是由第三方(例如并非商家所有)提供的服务,用于将商品配送到第三方关联营业地点(例如 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 日
报告服务
向“报告”服务添加了“近似竞争对手的竞争洞察”报告。
如需了解详情,请参阅我们的报告指南。
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 零售附加属性字段。此字段是重复字段,旨在供使用 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 个支持本地 contentLanguage
的 targetCountry
选项:
BR
ES
NL
JP
IT
KR
2023 年 1 月 12 日
产品服务
商品资源
添加了 lifestyleImageLinks
,以提供生活风格图片的网址。
2022 年 11 月 24 日
促销服务
在 Promotions.PromotionStatus 部分添加了新字段“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
。
针对现有 Feed,系统已使用 targetCountry
值自动填充 feedLabel
,以实现向后兼容性。
废弃了 targetCountry
。
为了支持全球优惠,Content API for Shopping 废弃了 targetCountry
字段。我们建议使用 shipping
字段指定您的目标国家/地区。
targetCountry
现在会自动填充您在 feedLabel
中提供的值。
如需了解详情,请参阅 Feed 标签取代了 Content API for Shopping 中的目标国家/地区这篇博文。
2021 年 12 月 8 日
账号服务
账号资源
在 Accounts 资源中新增了 Account.AutomaticImprovements 部分。
这个新版块可让商家自动更新商品、优化图片和配送设置。
2021 年 10 月 25 日
促销服务
向就促销 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
产品服务
商品资源
添加了 productLength
、productHeight
、productWidth
和 productWeight
,用于提供商品尺寸和重量。
2021 年 8 月 9 日
RepricingRule 服务
RepricingRule 类型
RepricingRuleType
字段的新枚举值。
添加了 TYPE_SALES_VOLUME_BASED
和 TYPE_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
添加了 minHandlingTime
、maxHandlingTime
、minTransitTime
和 maxTransitTime
,以提供商品级别的配送速度。
2021 年 1 月 28 日
账号服务
为 AccountLabel
和 Account
资源添加了自动标签支持。如需了解详情,请参阅 CSS 标签管理指南中的 CSS 标签类型部分。
2020 年 10 月 5 日
CSSES 服务
CSS 资源
新增了 csses
服务,用于检索有关 CSS 网域的信息并为其分配标签。AccountLabel
资源现在也可用于创建和列出 CSS 组级标签。如需了解详情,请参阅 CSS 标签管理。
2020 年 8 月 24 日
产品服务
商品资源
新增了 shoppingAdsExcludedCountries
字段,可用于阻止在特定国家/地区宣传某些商品。
Productstatuses 资源
destinationStatuses
对象中新增了 approvedCountries
、pendingCountries
和 disapprovedCountries
字段,用于提供 targetCountry
以外的优惠状态信息。
新的 itemLevelIssues.applicableCountries
字段。
2020 年 8 月 10 日
账号服务
添加了新的 AccountLabel
资源,用于管理 CSS Center 的 Merchant 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 日
Orderreturns 服务
添加了新方法 acknowledge
和 process
,以及用于读取方法的新过滤条件和字段(list
、get
)。
“Google 我的商家”账号关联
新增了使用 GMB 帐号 ID 将 Merchant Center 帐号与“Google 我的商家”帐号相关联的功能。
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 日
产品服务
支持在 Products 服务中添加的补充 Content API Feed。
2019 年 6 月 11 日
订单服务
Order 和 TestOrder 资源
添加价格调整
新增了 lineItem[].adjustments
字段,其中包含因应用促销活动而产生的对原订单项价格和税费的调整。
2019 年 2 月 14 日
此版本中引入的更改
不再支持试运行
参数 dryRun
已从 v2.1 中移除。这适用于所有 API 调用。
不再支持修补方法
以下服务不再支持 patch
方法:
- 账号
- 账号税费
- 数据 Feed
- Liasettings
- 运费设置
移除了 HTTP BATCH 方法
所有 HTTP BATCH
方法都已从 v2.1 中移除。请改用 customBatch
。
受影响的服务如下:
- 账号
- 账号状态
- 数据 Feed
- 数据 Feed 状态
- Liasettings
- 订单报告
- 排名
- 产品
- 商品状态
- 运费设置
账号服务
更新
首次发布 Content API v2 后,我们在请求中引入了字段 businessInformation
和 googleMyBusinessLink
。因此,采取了一项保护措施,可以防止商家无意中使用 update
删除这两个字段中的信息(如果未提供这些信息)。
在 v2 中,商家必须为这些字段明确提供空正文 ( {}
) 才能将其删除。在 v2.1 中,如果您提供空正文或未提供正文,则系统会删除相应字段。
账号资源
AdWords -> Google Ads 品牌更名
随着 AdWords 更名为 Google Ads,以下与 AdWords 相关的字段已重命名:
adwordsLinks
->adsLinks
adwordsLinks.adwordsId
->adsLinks.adsId
移除了已弃用的字段和值
移除了已弃用的字段 reviewsUrl
。此外,adsLinks
、googleMyBusinessLink
和 youtubeChannelLinks
的关联状态 inactive
也已被移除。
Accountstatuses 服务
AccountStatus 资源
移除了 dataQualityIssues
这些控件已被 itemLevelIssues
取代。
Datafeed 服务
Datafeed 资源
移除了已弃用的字段
在 targets
中,字段 contentLanguage
、targetCountry
和 intendedDestinations
已被移除并替换为 country
、language
、includedDestinations
和 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
中的顶级字段。
此外,在 Order
和 TestOrder
中,customer.explicitMarketingPreference
已被移除并替换为 customer.marketingRightsInfo
。
移除了已弃用的字段 customer.email
。
Order
资源中的 promotions
字段格式已更改。
Orderpayments 服务
此服务已从 v2.1 中移除。
产品服务
insert
的响应将仅包含以下属性:
channel
contentLanguage
id
offerId
targetCountry
响应中不再返回非严重警告和错误。这样就可以更好地与 Feed 规则和其他高级 Feed 管理功能集成。
现在,get
或 list
会延迟几分钟才能检索插入的商品。
无法保证返回的优惠 ID 与输入的优惠 ID 相同。
现在,系统会先验证价格,然后再插入商品。值字符串中仅允许使用以下字符:+
、-
、.
和数字 (0
-9
)。系统不再接受英文逗号。
商品资源
CustomGroups 已替换为递归 customAttributes
以前,通过在 v2 中的同一自定义组下添加自定义属性,可以将自定义属性组合在一起。自定义属性现在在 v2.1 中是递归属性,因此无需自定义组。
除了原始 value
字段之外,自定义属性现在还具有额外的 groupValues
字段;必须设置其中一个字段,这意味着它们不能同时设置或省略。
由于商家可能会在 v2 和 v2.1 之间切换,因此商品可能具有递归自定义属性,这些属性在 v2 中无法表示,因为自定义组最多具有两个级别。在这种情况下,自定义属性组将被截断。
移除了 customAttributes 中的类型和单位
在 v2.1 中,自定义属性将不再包含 type
和 unit
。系统应该会自动检测到要附加到 value
的单位(如果存在)和类型。例如,在 v2.1 中使用“1.23 EUR”或“5.6 cm”作为 value
。
ProductTypes 取代 productType 和 additionalProductTypes
以前,商品类型存储在两个字段中,第一种类型存储在单数字段 productType
中,其余类型存储在重复字段 additionalProductTypes
中。在 v2.1 中,这两个字段已替换为单个重复字段 productTypes
。
平台属性已替换为 includeDestinations 和 excludedDestinations
在 v2 中的重复字段 destinations
中输入了目的地,即目的地名称和意图对的列表。此字段已替换为以下两个重复字段:includedDestinations
和 excludedDestinations
。默认启用的目标平台无需包含在 includedDestinations.
中。这与 Feed 中目标平台替换的配置相一致。
重命名与 AdWords 相关的字段
随着 AdWords 更名为 Google Ads,以下与 AdWords 相关的字段已重命名:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
移除了已弃用的字段
移除了以下已弃用的字段:
aspects
destinations
onlineOnly
validatedDestinations
warnings
Productstatuses 服务
Get 和 List
移除了 product
属性以及 includeAttributes
参数。如需检索与状态对应的商品属性,请使用 Products
服务和新 productId
字段的值。
列表
参数 includeInvalidInsertedItems
已被移除。现在,所有商品都会返回(无论其是否有效),这意味着 list
现在的行为就像 includeInvalidInsertedItems
始终设置为 true
一样。
ProductStatus 资源
DestinationsStatuses
destinationStatuses
中的 intention
、approvalStatus
和 approvalPending
字段已替换为 status
,后者是一个字符串,其可以是 approved
、disapproved
或 pending
。
移除了 dataQualityIssues
这些控件已被 itemLevelIssues
取代。