版本说明 (v2.1)

2024 年 11 月 15 日

产品服务

对于 LoyaltyProgram，添加了 shipping_label 字段以指定资格条件。如果此字段有值，则表示此商品提供会员配送福利。如果未提供此字段值，则商品不符合指定会员层级的会员配送条件。

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 日

账号服务

为 link 方法分别添加了 localProductManager 和 localProductManagement 作为链接类型和服务。这类角色允许账号关联，以便管理本地商品数据。

2023 年 11 月 29 日

商家支持服务

添加了 VERIFY_IDENTITY_IN_MERCHANT_CENTER 外部操作类型，用于在 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 取件点），而不是直接配送到住址。

2023 年 9 月 18 日

LIA 设置服务

添加了 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 目标账号的客户使用。使用此字段后，在使用云端零售计划时，此字段将可用。此字段将映射到 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 日

报告服务

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

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

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

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 关联

添加了使用 GMB 账号 ID 将 Merchant Center 账号关联到 GMB 账号的功能。

2020 年 4 月 14 日

Settlement Report 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 易购添加了新的 Returnpolicy 和 Returnaddress 服务。

订单服务

有序资源

新字段

新增了 quantityUndeliverable 字段。

2019 年 8 月 7 日

订单服务

有序资源

新字段

向 Order 资源添加了新的 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
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • 排名
  • 产品
  • Productstatuses
  • Shippingsettings

账号服务

更新

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

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

Account 资源

品牌从 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

类型为 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 服务

Get 和 List

product 属性以及 includeAttributes 参数已被移除。如需检索与状态对应的商品属性，请使用 Products 服务和新的 productId 字段的值。

列表

移除了 includeInvalidInsertedItems 参数。无论商品是否有效，所有商品都已返回。也就是说，list 现在的行为类似于 includeInvalidInsertedItems 始终设置为 true。

ProductStatus 资源

DestinationsStatuses

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

移除 dataQualityIssues

这些已被 itemLevelIssues 取代。