版本说明 (v2.1)

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 日

产品服务

产品资源

添加了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 日

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

向报告服务添加了市场洞察报告。

现在，您可以通过报告服务查询以下内容：

有关详情，请参阅我们的报告 指南。

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 相关的字段已重命名：

  1. adwordsLinks -> adsLinks
  2. 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:

订单服务

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 更名为 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取代。