Business Information API

更新日志

v1

API 权限

Business Information API 将需要从 GCP Console 启用。OAuth 范围保持不变。

端点网址

可以通过 https://mybusinessbusinessinformation.googleapis.com/v1/（而不是 https://mybusiness.googleapis.com/v4/）访问用于搜索所有商家信息、属性、类别、连锁店和营业地点的端点

营业地点端点的路径名称已从 accounts/accountId/locations/locationId 更改为 locations/locationId

营业地点更新

  • locationName 已重命名为 title。
  • websiteUrl 已重命名为 websiteUri。
  • accounts.locations.list 和 locations.get 现在需要 readMask。
  • primaryPhone 和 additionalPhones 现在是 PhoneNumbers 的一部分。
  • primaryCategory 和 additionalCategories 现在是 Categories 的一部分。
  • address 已重命名为 storefrontAddress。
  • accounts.locations.clearAssociation 已更新为 locations.clearLocationAssociation。
  • serviceItems 现在可以直接从 Location 对象读取和更新。

属性

  • 新增 Attributes 对象和相应的 locations.attributes.getGoogleUpdated 端点，用于获取 Google 更新的版本。
  • attributes.list 具有一个 show_all 参数，使客户端能查看可针对特定类别和区域组合设置的各种属性。

上门服务商家

  • CUSTOMER_LOCATION_ONLY 类型的商家不再需要填写地址。
  • 在 ServiceAreaBusiness 中添加了 regionCode。必须为 CUSTOMER_LOCATION_ONLY 类型的商家设置此值。

已弃用的端点和对象

  • 移除了 LocationKey 对象。现有字段已移至元数据。
  • 移除了 PriceLists 对象。该字段已被 FoodMenus 和 ServiceLists 取代。
  • 移除了 LocationState 对象。大多数现有字段已移至元数据。虽然元数据包含一个布尔值，用于查看商家是否拥有对业务的完全控制权（商家发言权），但与暂停和验证相关的更详细的字段已移至 Verifications API。在获取商家发言权的后续步骤中使用方法 locations.getVoiceOfMerchantState。
  • 端点 googleLocations.report 和 accounts.locations.findMatchingLocations 已弃用。
  • 端点 TransferLocation 已移至 Account Management API 下的 locations.transfer。