Merchant Accounts API 版本说明

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 日当周

  • 推出了“在线退货政策”资源，让 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 进行过滤。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 日当周

CreateAndConfigureAccountRequest 的 users 字段已被弃用，取而代之的是新的 user。被引用的 CreateUserRequest 包含 CreateAndConfigureAccountRequest 上下文中不需要的 parent 字段。

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 版发布