版本说明 (v2.1)

2024 年 10 月 30 日

在关停与结算相关的 API 的过程中，我们已废弃以下服务： - settlementreports - settlementtranscations

与和解相关的 API 的关停与之前关停的 BuyOnGoogle 计划以及与订单相关的 API 有关。

对上述服务的调用预计会失败并返回 Service was not found on the server 响应。

2024 年 10 月 16 日

UpdateConversionSourceRequest 中的 update_mask 现已更名为 OPTIONAL。如果未指定更新掩码，则系统会更新所有值不为空的字段。

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 字段。

报告服务

弃用了 MerchantPerformanceView 表格中的“Google 易购”指标。完成此更新后，检索任何 Google 易购指标都会返回 0。这也适用于过去日期的历史值。

如需了解详情，请参阅“Google 易购”功能的弃用。

2024 年 5 月 13 日

产品服务

Product 资源

对认证字段的更改：向 ProductCertification 字段添加了 certificationValue 以提供认证值（也称为类、等级或等级），这样一来，即使认证机构未颁发认证代码或编号，用户也可以上传认证信息。

如需了解详情，请参阅我们的产品指南。

2024 年 5 月 6 日

报告服务

向 PriceInsightsProductView 表格添加了效果分桶。 效果指示哪些商品在调价后受益最大。此评分会考虑调整促销价以及当前价格与建议价格之间的差值预计会提升的效果。

2024 年 4 月 24 日

产品服务

Product 资源

为分期付款添加了可选的 downpayment 和 creditType 字段：

  • downpayment 用于提供买家需要预付的一次性付款金额。
  • creditType 用于提供分期付款类型（finance 或 lease）。此字段仅适用于车辆广告。

2024 年 4 月 11 日

产品服务

Product 资源

  • 为商品级配送添加了免运费门槛属性 (FreeShippingThreshold)。通过此属性，商家可以输入使运费变为免费的最低商品价格。
  • 更改了LoyaltyPoints的公开范围

2024 年 4 月 10 日

产品服务

Product 资源

添加了LoyaltyProgram

2024 年 4 月 9 日

产品服务

Product 资源

添加了 structuredTitle 和 structuredDescription，以提供 AI 生成的商品名和说明。

2024 年 4 月 3 日

商家支持服务

添加了 user_input_action_option 字段，允许合作伙伴请求新类型的操作：BuiltInUserInputAction。借助此操作，合作伙伴可以直接在其应用中为商家构建复杂的自助功能，而无需将商家重定向到 Merchant Center。

为 BuiltInUserInputAction 添加了新的 TriggerAction 方法。如需使用此方法，请通过此表单提交申请。

2024 年 3 月 27 日

产品服务

Product 资源

在“自动折扣”和“动态促销”项目中添加了 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 商店与 Google 商家资料商店的匹配状态，并在出现问题时提供修复提示。

2023 年 11 月 15 日

repricingrules 和 repricingrules.repricingreports 端点不再受支持。

2023 年 11 月 1 日

配送设置服务

shipment_type=pickup 已不再受支持。

2023 年 10 月 18 日

账号服务

新增了 Business Identity 字段，可让商家针对特定消费者价值自行标识。

2023 年 10 月 10 日

将 Collection Point 添加为送货设置服务的新配送类型。取件点配送是由第三方（例如非商家自有）提供的服务，用于将商品配送到第三方关联地点（例如 UPS Access Points），而不是直接配送到家。

2023 年 9 月 18 日

本地商品目录广告设置服务

添加了 setOmnichannelExperience 方法，以允许用户设置全渠道体验（即本地店面和自提设置）。目前，只有 POS 提供商可信且可以启用此类设置的用户才能使用此功能。

2023 年 9 月 7 日

弃用“在 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 日

产品服务

Product 资源

添加了 virtualModelLink，用于提供 3D 模型图片的网址。

2023 年 7 月 4 日

产品服务

Product 资源

添加了 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 商品模型中的“attributes”字段。

2023 年 5 月 22 日

促销服务

为 Promotions 服务添加了 list 方法。

2023 年 4 月 11 日

配送设置服务

本地执行方式

为创建新的配送设置的商家添加了本地送货履单选项。他们可以在新的 storeConfig 字段中配置本地商店的设置。这包括提供本地配送服务的商店的服务半径、截止时间和商店代码。

4 月 3 日

推荐服务

推出了推荐服务。此服务会提供建议的方法来提升商家账号的效果，并让您能够报告商家点击了哪些实用建议。

2023 年 2 月 20 日

账号服务

Account 资源

在账号资源中添加了新部分 Account.ConversionSettings。

ConversionSources 服务

添加了转化来源服务，该服务支持管理转化来源（Merchant Center 的“转化设置”部分的一部分）。

2023 年 2 月 16 日

配送设置服务

商店代码验证

现在，系统会在更新运费设置之前验证商店代码，以确保它们属于商家。

LIA 商家验证

现在，在更新配送设置之前，系统会先验证商家 ID 已注册的计划。商家必须参与以下某个计划：

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

2023 年 2 月 9 日

促销服务

将促销活动服务扩展到另外 6 个 targetCountry 选项，并提供本地 contentLanguage 支持：

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

2023 年 1 月 12 日

产品服务

Product 资源

添加了 lifestyleImageLinks，用于提供生活方式图片的网址。

2022 年 11 月 24 日

促销服务

在 Promotions.PromotionStatus 部分中添加了新字段“promotionStatus”。此字段是只读字段。

2022 年 11 月 15 日

Reports 服务

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

您现在可以向报告服务查询以下内容：

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

2022 年 11 月 7 日

Datafeeds 服务

为数据 Feed 服务添加了 feedLabel 支持。

2022 年 9 月 14 日

更新了 feedLabel，以接受任何字符串。

2022 年 8 月 9 日

为商品添加了 feedLabel。

现在，您可以使用 feedLabel（而非 targetCountry）为商品 ID 指定国家/地区。优惠 ID 现在采用 online:language:feedLabel:offerId 的格式构建。

为实现向后兼容，系统已自动为现有 Feed 的 feedLabel 填充了您的 targetCountry 值。

废弃了 targetCountry。

为了支持全球商品，Content API for Shopping 已废弃 targetCountry 字段。我们建议您改用 shipping 字段来指定目标国家/地区。

现在，系统会自动使用您在 feedLabel 中提供的值填充 targetCountry。

如需了解详情，请参阅博文Feed 标签取代了 Content API for Shopping 中的目标国家/地区。

2021 年 12 月 8 日

账号服务

Account 资源

在账号资源中添加了新的 Account.AutomaticImprovements 部分。

借助这个新版块，商家可以自动更新商品、改进图片和配送设置。

2021 年 10 月 25 日

促销服务

向 Promotion API 添加 Get Promotion。

2021 年 10 月 11 日

Shipping Settings API

在 ShippingSettings 资源中添加了新的 warehouse 字段，以便商家管理可在 WarehouseBasedDeliveryTime 中使用的仓库。

在 WarehouseBasedDeliveryTime 中添加了新的 warehouseName 字段，以便按仓库名称引用仓库。

2021 年 10 月 4 日

账号服务

Account 资源

在 Accounts.BusinessInformation 部分中添加了新字段“phone_verification_status”。这是一个只读字段，由 Accounts.VerifyPhoneNumber 进行设置。

2021 年 9 月 13 日

BuyOnGooglePrograms 服务

BuyOnGoogleProgramStatus 资源

在 BuyOnGooglePrograms.BuyOnProgramStatus 资源中添加了新字段，用于表示：在线销售渠道、业务模式和客户服务电话。

新增了 UpdateBuyOnGoogleProgramStatus 方法

添加了新的 UpdateBuyOnGoogleProgramStatus 方法，用于更新扩展的 BuyOnGooglePrograms.BuyOnProgramStatus 资源。

2021 年 9 月 6 日

账号服务

Account 资源

在 Accounts.BusinessInformation 部分中添加了新字段“korean_business_registration_number”。只有在明确设置空字符串时，系统才会清除此字段。

2021 年 8 月 30 日

促销服务

添加了新的促销服务，其中包含插页式广告促销。

订单服务

添加了新方法 orders/captureOrder，以便在发货前扣款。

新的订单取消原因：FAILED_TO_CAPTURE_FUNDS

产品服务

Product 资源

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

产品服务

Product 资源

新增了 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 用户现在还可以使用 accounts.list、accounts.get 和 accounts.updatelabels 方法列出其 Merchant Center 账号并为其分配标签。如需了解详情，请参阅 CSS 标签管理。

2020 年 6 月 19 日

产品服务

Product 资源

新字段

新增了 productDetails、productHighlights、subscriptionCost 和 canonicalLink 字段。

2020 年 6 月 2 日

订单服务

添加了新方法，以便在不退货的情况下发起退款。借助新的 orders.refunditem 和 orders.refundorder，您可以为订单发起退款，即使客户未退货也是如此。

2020 年 4 月 27 日

Orderreturns 服务

添加了新的 acknowledge 和 process 方法，以及用于读取方法的新过滤器和字段（list、get）。

GMB 关联

添加了使用“Google 我的商家”账号 ID 将 Merchant Center 账号与“Google 我的商家”账号相关联的功能。

2020 年 4 月 14 日

结算报告 API

添加了一项用于获取结算报告的新服务。

2020 年 3 月 9 日

Local inventory API

添加了一项用于提交本地商品目录数据的新服务。

2020 年 3 月 2 日

Pubsub 通知设置 API

添加了一项新服务，用于管理发布/订阅通知的设置。

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 日

此版本中引入的变更

不再支持空运行

v2.1 中移除了参数 dryRun。这适用于所有 API 调用。

不再支持 patch 方法

以下服务不再支持 patch 方法：

  • 账号
  • Accounttax
  • 数据 Feed
  • Liasettings
  • Shippingsettings

移除 HTTP BATCH 方法

v2.1 中移除了所有 HTTP BATCH 方法，请改用 customBatch。 受影响的服务如下：

  • 账号
  • Accountstatuses
  • 数据 Feed
  • 数据 Feed 状态
  • 利亚设置
  • Orderreports
  • 排名
  • 产品
  • Productstatuses
  • Shippingsettings

账号服务

更新

首次发布 Content API v2 之后，我们在请求中加入了字段 businessInformation 和 googleMyBusinessLink。为此，我们推出了一项保护措施，可以防止商家无意中使用 update 删除这两个字段（如果 update 中未提供）中的信息。

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

账号资源

品牌从 AdWords 更名为 Google Ads

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

  1. adwordsLinks -> adsLinks
  2. 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 中替换为两项新功能：

订单服务

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）。不再接受英文逗号。

Product 资源

CustomGroups 已替换为递归 customAttributes

以前，通过将自定义属性添加到 v2 中的同一自定义组下，可以将自定义属性组合在一起。现在，自定义属性在 v2.1 中是递归属性，因此无需自定义组。

除原始 value 字段外，自定义属性现在还具有其他 groupValues 字段；其中只有一个必须设置，即它们不能同时设置或省略。

由于商家可能会在 v2 和 v2.1 之间切换，因此商品可能会具有在 v2 中无法表示的递归自定义属性，因为自定义组最多有两个级别。在这种情况下，将截断自定义属性组。

移除 customAttributes 中的类型和单位

在 v2.1 中，自定义属性不再包含 type 和 unit。系统应该会自动检测到要附加到 value（如果存在）中的单位和类型。例如，将“1.23 EUR”或“5.6 cm”用作 v2.1 中的 value。

ProductTypes 取代 productType 和 additionalProductTypes

以前，商品类型存储在两个字段中，第一种类型存储在单数字段 productType 中，其余类型存储在重复的字段 additionalProductTypes 中。在 v2.1 中，这两个字段已替换为单个重复字段 productTypes。

Destinations 属性已替换为 includedDestinations 和 excludedDestinations

在重复的字段 destinations 中，输入的 Destinations 是 v2 中的平台名称和意图对列表。此字段已替换为以下两个重复的字段：includedDestinations 和 excludedDestinations。默认情况下，启用的目标平台不必包含在 includedDestinations. 中。这样才会匹配 Feed 中平台替换的配置。

随着 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

destinationStatuses 中的字段 intention、approvalStatus 和 approvalPending 已替换为 status，后者是一个字符串，可以是 approved、disapproved 或 pending。

移除 dataQualityIssues

这些已被 itemLevelIssues 取代。