版本说明 (v2.1)

2024 年 3 月 6 日

报告服务

为商品添加了获得点击的潜力大类和排名。

如需了解详情,请参阅我们的报告指南

2024 年 3 月 8 日

报告服务

Reports 服务添加了 TopicTrendsView 报告。

如需了解详情,请参阅我们的报告指南

2024 年 2 月 19 日

ConversionSources 服务

移除了以下作为有效转化来源的值:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

移除了作为回溯期天数的选项 60 和 90 天,添加了 40 天作为有效选项。

2024 年 3 月 15 日

适用于 Google 搜索和 Google 购物的 Google 易购即将停用。在 2024 年 10 月 31 日之前,您可以使用 orders.listorders.get 继续查看现有订单。

2024 年 1 月 17 日

销售终端 (POS) 服务

PosStore 中的 matching_status_hint 字段添加了新值,让用户可以更详细地了解其商店匹配失败的原因。

2024 年 1 月 11 日

Accounts 服务

link 方法分别添加了 localProductManagerlocalProductManagement 作为链接类型和服务。这样,帐号关联后,您就可以管理本地商品数据了。

2023 年 11 月 29 日

商家支持服务

为需要在 Merchant Center 中执行的身份验证添加了 VERIFY_IDENTITY_IN_MERCHANT_CENTER 外部操作类型。

销售终端 (POS) 服务

PosStore 添加了 matching_statusmatching_status_hint 字段,以便用户了解 Pos Store 与 Google 商家资料商店的匹配状态,并在出现问题时提示修正问题。

2023 年 11 月 15 日

不再支持 repricingrulesrepricingrules.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_methodpickup_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 目标的客户使用。使用此字段后,在使用 Cloud Retail 计划时便可使用此字段。此字段将映射到 Google Cloud Retail 产品(https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.branches.products#Product) 模型中的属性字段。

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 服务:

如需了解详情,请参阅我们的报告指南

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

产品服务

商品资源

添加了 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 用户现在还可以列出其 Merchant Center 帐号,并使用 accounts.listaccounts.getaccounts.updatelabels 方法为其分配标签。如需了解详情,请参阅 CSS 标签管理

2020 年 6 月 19 日

产品服务

商品资源

新字段

新增了 productDetailsproductHighlightssubscriptionCostcanonicalLink 字段。

2020 年 6 月 2 日

订单服务

添加了新方法来发起退款不退货操作。借助新的 orders.refunditemorders.refundorder,即使客户未退回订单,您也可以发起退款。

2020 年 4 月 27 日

Orderreturns 服务

添加了新方法 acknowledgeprocess,以及用于读取方法的新过滤条件和字段(listget)。

“Google 我的商家”账号关联

新增了使用“Google 我的商家”帐号 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 日

订单服务

订单资源

新字段

为订单资源添加了新的 loyaltyInfoinvoiceReceivingEmail 字段。

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 后,我们在请求中引入了字段 businessInformationgoogleMyBusinessLink。因此,采取了一项保护措施,可以防止商家无意中使用 update 删除这两个字段中的信息(如果未提供这些信息)。

在 v2 中,商家必须为这些字段明确提供空正文 ({}) 才能将其删除。在 v2.1 中,如果您提供空正文或未提供正文,则系统会删除相应字段。

账号资源

AdWords -> Google Ads 品牌更名

随着 AdWords 更名为 Google Ads,以下与 AdWords 相关的字段也进行了重命名:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
移除了已弃用的字段和值

移除了已弃用的字段 reviewsUrl。此外,adsLinksgoogleMyBusinessLinkyoutubeChannelLinks 的关联状态 inactive 也已被移除。

Accountstatuses 服务

AccountStatus 资源

移除了 dataQualityIssues

这些控件已被 itemLevelIssues 取代。

Datafeed 服务

Datafeed 资源

移除了已弃用的字段

targets 中,字段 contentLanguagetargetCountryintendedDestinations 已被移除并替换为 countrylanguageincludedDestinationsexcludedDestinations

移除商品目录更新

已移除 product inventory update 类型的 Feed。

房源/票源服务

v2 inventory 服务在 v2.1 中已被移除并由两项新功能取代:

订单服务

CancelLineItem

请求中的字段 amountamountPretaxamountTax 已被移除。系统现在会自动计算退款金额。

CustomBatch

已从 v2.1 中移除 CustomBatch

InStoreRefundLineItem

字段 amountPretaxamountTax 已分别替换为 priceAmounttaxAmount。字段 priceAmount 可能是税前或税后值,具体取决于订单的地理位置。

退款

此方法已被移除。请改用 returnRefundLineItem

ReturnLineItem

此方法已被移除。请改用 returnRefundLineItem,而不提供退款金额。

ReturnRefundLineItem

字段 amountPretaxamountTax 已分别替换为 priceAmounttaxAmount。字段 priceAmount 可能是税前或税后值,具体取决于订单的地理位置。

ShipLineItem

请求中的字段 carriershipmentIdtrackingId 已移至 shipmentInfos

Order 和 TestOrder 资源

新的促销活动格式

v2.1 中有一种新的促销格式。目前,无法创建包含促销活动的测试订单,但将在后续阶段添加支持。

移除了已弃用的字段

字段 paymentMethod 已被移除,billingAddresspredefinedBillingAddress 现在分别是 OrderTestOrder 中的顶级字段。

此外,在 OrderTestOrder 中,customer.explicitMarketingPreference 已被移除并替换为 customer.marketingRightsInfo

移除了已弃用的字段 customer.email

Order 资源中的 promotions 字段格式已更改。

Orderpayments 服务

此服务已从 v2.1 中移除。

产品服务

insert 的响应将仅包含以下属性:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

响应中不再返回非严重警告和错误。这样就可以更好地与 Feed 规则和其他高级 Feed 管理功能集成。

现在,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 中。在 v2.1 中,这两个字段已替换为单个重复字段 productTypes

平台属性已替换为 includeDestinations 和 excludedDestinations

在 v2 中的重复字段 destinations 中输入了目的地,即目的地名称和意图对的列表。此字段已替换为以下两个重复字段:includedDestinationsexcludedDestinations。默认启用的目标平台无需包含在 includedDestinations. 中。这与 Feed 中目标平台替换的配置相一致。

随着 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 中的 intentionapprovalStatusapprovalPending 字段已替换为 status,后者是一个字符串,其可以是 approveddisapprovedpending

移除了 dataQualityIssues

这些控件已被 itemLevelIssues 取代。