更新日志
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。