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。
• 现在，系统会直接从 Location 对象读取和更新 serviceItems。

属性

• 新增了 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。