Merchant Accounts API 版本说明

2026 年 4 月 20 日当周

  • 将 youtube-affiliate 添加到可用计划名称列表中，以 accounts.programs 资源说明。
  • 为 YouTube 购物联属营销计划启用计划 API。可信测试员可以使用。

2026 年 4 月 6 日当周

  • 在“审批状态”中添加了 WAITING 状态。对于购物比较服务 (CSS)，WAITING 是 PENDING 和 ESTABLISHED 之间的过渡状态。 当原始 CSS 需要时间执行任何必要的清理操作，然后才能将账号完全转移到新的 CSS 时，可以使用此状态。

2026 年 3 月 16 日当周

  • 在 Accounts API 中推出了 CreateTestAccount 方法。借助此方法，开发者可以以编程方式创建在类似沙盒的隔离环境中运行的专用测试账号，从而提供一个安全空间来开发和测试集成。

2025 年 11 月 17 日当周

  • CreateAndConfigureAccountRequest 现在提供可在账号设置期间配置的新服务。必须指定 AccountAggregation、AccountManagement 和 ComparisonShopping 中的一个。此外，还可以指定任意数量的 ProductsManagement 和 CampaignsManagement 服务。不过，不得有两个此类服务具有相同的提供商和外部账号 ID。

  • AccountsService.CreateAndConfigure 方法现在提供了一个设置，用于控制是否应发送验证邮件。

  • CreateAndConfigureAccountRequest.AddAccountService 现在具有 external_account_id 字段（此字段已存在于 AccountService 资源中）。它可以与 CampaignsManagement 和 ProductsManagement 服务一起指定。

  • 向 AccountService 资源添加了 ComparisonShopping 服务。如需了解详情，请参阅 https://support.google.com/merchants/answer/12653197。

  • 现在，您可以在创建账号时使用 CreateAndConfigureAccountRequest 中的 setAlias 字段为关系设置别名。

  • 向 UserService 添加了 VerifySelf 方法，该方法允许将代表进行调用的用户的 User 资源的状态从 PENDING 更新为 VERIFIED。

  • 在 Regions API 的 Region payload 中推出了新的 radius_area 字段，商家可以使用半径区域创建区域。

2025 年 11 月 10 日当周

  • 发布了 Services API 的 v1alpha 版本。
  • 在 Services API 的 CampaignManagement payload 中推出了新的 product_filters 字段，商家可以根据对商家商品属性的一些条件过滤，仅与 Google Ads 账号共享 Feed 的一部分。这是一项仅限部分商家使用的许可名单功能。

2025 年 8 月 25 日当周

  • 向 Regions API 添加了新的批量方法：
    • BatchCreateRegions：允许在单个请求中创建多个区域。
    • BatchUpdateRegions：允许在单个请求中更新多个区域。
    • BatchDeleteRegions：允许在单个请求中按名称删除多个区域。

2025 年 7 月 1 日当周

  • 推出了 CheckoutSettings 资源，API 用户可以使用该资源创建、更新、删除和获取 checkoutSettings。

2025 年 5 月 26 日当周

  • 现在可以按 capabilities 过滤账号。目前，唯一可能的值是 CAN_UPLOAD_PRODUCTS。借助此过滤条件，您可以检索能够上传商品的账号。这意味着，现在可以在账号级使用以下子句：

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS 如需了解详情，请参阅 过滤指南。

  • 推出了只读访问权限。拥有只读访问权限的用户可以查看商家数据，但无法修改。

2025 年 5 月 19 日当周

  • 更新了计划 API 的文档，移除了有关 Enable/Disable 方法仅限管理员用户的错误声明。

2025 年 5 月 12 日当周

  • 推出了 Online Return Policy 资源，API 用户可以使用该资源创建、更新和删除退货政策。
  • 推出了 OmnichannelSettingsService 和 OmnichannelSetting 资源，API 用户可以使用这些资源管理其全渠道体验。
  • 推出了 LfpProvidersService 和 LfpProvider 资源，API 用户可以使用这些资源管理其本地 Feed 合作伙伴关系。
  • 推出了 GbpAccountsService 和 GbpAccount 资源，API 用户可以使用这些资源管理其 Google 商家资料。
  • 在 AccountService 中推出了服务类型 LocalListingManagement，该服务类型会关联用于本地商品目录广告或非付费本地商品详情的商家群组。

2025 年 4 月 28 日当周

  • 推出了 AccountService 和 AccountRelationship 资源，API 用户可以使用这些资源管理关系并建立与服务提供商的服务。

2025 年 4 月 14 日当周

  • TermsOfServiceService.AcceptTermsOfService 现在会返回以响应类型封装的已接受的 TermsOfServiceAgremeentState。

  • TermsOfServiceService.AcceptTermsOfService 操作的动词现在是 POST（以前是 GET）。

  • 阐明了需要使用 accounts/... 格式（而不是 providers/...）调用 AccountsService.ListSubAccounts。这是为了避免此方法超出 accounts 范围（即 GET accounts/123:listSubAccounts 而不是 GET providers/123:listSubAccounts）。

2025 年 3 月 31 日当周

  • 对于过滤账号，externalAccountId 过滤条件已在 2024 年 12 月 2 日当周宣布废弃，现在已不可用。这意味着，现在只能在 service 级按 externalAccountId 进行过滤。 A 诸如 relationship(externalAccountId = "foo") 之类的过滤条件将不再有效 并且 需要表示为 relationship(service(externalAccountId = "foo"))。

  • 在 AccountsService 文档中阐明了无法创建独立账号。

2025 年 3 月 3 日当周

-重构了 accounts.onlineReturnPolicies#SeasonalOverride ，以提高清晰度和一致性。这些更新包括：

  • 字段重命名：
    • begin 现在是 start_date。
    • end 现在是 end_date。
  • 字段移除：
    • 已移除已废弃的 policy 字段。

-开发者应更新其代码以反映这些更改。

推出了 AutomaticImprovements 服务，您可以使用该服务来管理以下内容：

如需了解详情， 请参阅启用自动优化。

2025 年 2 月 17 日当周

从账号过滤条件中移除了 callerHasAccessToProviderFilter() 谓词。

2025 年 2 月 10 日当周

  • 改进了 AccountsService.List 方法的文档。它会返回用户有权访问的所有账号，而不仅仅是独立账号。

  • 为所有 RPC 方法添加了 10 分钟的默认截止期限。

  • 在 accounts.programs 资源说明中添加了可用计划名称列表。

  • User.accessRights 现在是 REQUIRED，会影响 UserService.Create 和 AccountsService.CreateAndConfigure 方法。

2025 年 1 月 27 日当周

AccountsService.ListAccounts （以及传递的 AccountsService.ListSubAccounts）现在以最终一致的方式返回账号，而不是强读取。

2025 年 1 月 20 日当周

为了支持新的 user，CreateAndConfigureAccountRequest 的 users 字段已废弃。引用的 CreateUserRequest 包含 parent 字段，该字段在 CreateAndConfigureAccountRequest 的上下文中不是必需的。

2025 年 1 月 6 日当周

现在，CreateUserRequest 消息的 user 字段已正确标记为 OPTIONAL。

现在，返回的错误中的 domain 字段填充的是 merchantapi.googleapis.com，而不是 global

2024 年 12 月 2 日当周

对于过滤账号，externalAccountId 谓词已从 relationship 级移至 service 级。因此，过滤条件 relationship(externalAccountId = "foo") 现在需要 写为 relationship(service(externalAccountId = "foo"))。为了支持向后兼容，旧格式仍受支持，但已废弃，并且在不久的将来会抛出错误。所有文档都只会提及新格式。

2024 年 11 月 18 日当周

现在，CreateAndConfigureAccountRequest.service.provider 字段中的提供商也可以是 providers/GOOGLE_ADS 或 providers/GOOGLE_BUSINESS_PROFILE 之一。其他账号应称为 providers/123（而不是 accounts/123）。这意味着，该字段不再被注解为账号引用。不过，为了支持向后兼容，仍然可以使用账号名称（例如 accounts/123）。

ListSubAccountsRequest 中的提供商现在应采用 providers/123 形式，但为了支持向后兼容，仍然可以使用 accounts/123。

2024 年 11 月 4 日当周

在 BusinessIdentity 资源中，将 promotions_consent 标记为 REQUIRED（从 OPTIONAL）。这只会影响更新方法。这是为了阐明无法将 promotions_consent 更新为 UNSPECIFIED。这之前就无法实现，但现在的错误描述性更强，并且字段已正确注解。

2024 年 10 月 28 日当周

改进了 Accounts 子 API 的各种资源（例如 User、Homepage、BusinessInfo 等）的文档。

2024 年 10 月 21 日当周

改进了整个更新请求中的 update_mask 字段的文档，以明确指出哪些字段支持更新。

为 ShippingSettings 资源的外部文档添加了 Google 商家帮助中心链接，其中列出了支持的运营商

2024 年 10 月 14 日当周

在 AccountsService.CreateAndConfigureAccountRequest.AddAccountService 中，将 provider 标记为 REQUIRED。

使整个 Accounts 子 API（例如商家身份、商家信息、首页等）中的 update_mask 成为可选字段，并追溯到 ConversionSources 资源。

向 ClaimHomepageRequest 添加了 overwrite 参数。

2024 年 9 月 30 日当周

推出了“Accounts.delete”方法的“force”参数。

2024 年 9 月 23 日当周

在 RetrieveLatestTermsOfServiceRequest 中，将 region_code 和 kind 标记为 REQUIRED。

2024 年 9 月 16 日当周

在 ListAccountIssuesRequest 中，将 time_zone 参数的类型更改为字符串

2024 年 8 月 12 日当周

向 BusinessInfo 资源添加了 korean_business_registration_number 字段。

2024 年 5 月 27 日当周

推出了 Accounts 子 API 的 Beta 版