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_PRODUCTSNOT 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 日当周
对于过滤账号,我们已于 2024 年 12 月 2 日当周宣布弃用
externalAccountId过滤条件,该过滤条件现已无法使用。这意味着,现在只能在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 字段的文档,明确指出哪些字段支持更新。
为支持的运营商添加了 Google 商家帮助中心链接,以添加到 ShippingSettings 资源的外部文档中
2024 年 10 月 14 日当周
将 AccountsService.CreateAndConfigureAccountRequest.AddAccountService 中的 provider 标记为 REQUIRED。
使整个 Accounts 子 API 中的 update_mask 成为可选属性(例如商家身份、商家信息、首页等),并针对 ConversionSources 资源进行追溯性更改。
向 ClaimHomepageRequest 添加了 overwrite 参数。
2024 年 9 月 30 日当周
针对“Accounts.delete”方法推出了“force”参数。
2024 年 9 月 23 日当周
将 region_code 和 kind 标记为 RetrieveLatestTermsOfServiceRequest 中的 REQUIRED。
2024 年 9 月 16 日当周
在 ListAccountIssuesRequest 中将 time_zone 参数的类型更改为字符串
2024 年 8 月 12 日当周
为 BusinessInfo 资源添加了 korean_business_registration_number 字段。
2024 年 5 月 27 日当周
Accounts 子 API Beta 版发布