更新日志

v4.9

新功能

MoreHours
MoreHours 现在可设为商家信息的一部分。
可使用 categories.batchGet 检索各个类别的 MoreHourTypes。

行为更改

v4.x Accounts 弃用
Google My Business API 中现已弃用 accounts、accounts.admins、accounts.invitations 和 accounts.locations.admins。如需了解详情，请参阅弃用更新日志。
CallToAction 帖子
在 2021 年第 2 季度，ActionType 为 GET_OFFER 的 CallToAction 帖子将不再有效。

v4.8

新功能

住宿设施
检索和更新住宿设施。了解详情
添加了可用于住宿的 GetGoogleUpdated 端点。
LocationState 中添加了 canOperateLodgingData 布尔值
保健提供商属性
检索和更新 HealthProviderAttributes。了解详情
LocationState 中添加了 canOperateHealthData 布尔值
保险网络
列出营业地点接受的保险网络。了解详情

行为更改

评价 ID
评价 ID 已改用新格式。系统现在会在所有适用的 API 响应中返回此新 ID。短时间内，旧评价 ID 在用于调用该 API 时，仍会进行解析，但根据我们的政策，您必须在 30 天内通过调用 listReviews 端点刷新系统中存储的所有评价 ID。
上门服务商家
在 2021 年第 1 季度，对于 CUSTOMER_LOCATION_ONLY 商家，Location 对象中将不再返回 Address。

v4.7

新功能

食品菜单
检索和更新 FoodMenus。了解详情

v4.6

新功能

服务列表
现在，您可以检索和更新商家提供的服务。了解详情
LocationState 中添加了 canModifyServiceList 布尔值
用于指明某个营业地点是否可以修改服务列表。了解详情
Categories 的预定义 ServiceTypes
预定义的服务类型现在包含在 categories 对象中。了解详情
CategoryView
能够为类别指定 BASIC 或 FULL 视图。FULL 视图将返回更多详细信息，例如服务类型。了解详情
Categories.BatchGet 方法
借助这种新方法，您可以输入类别列表，并仅返回有关这些类别的信息。了解详情

v4.5 COVID-19 Update 2

新功能

COVID-19 提醒帖子类型
现在，您可以通过该 API 创建 COVID_19 帖子。了解详情。

v4.5 COVID-19 Update 1

新功能

暂停营业
现在，您可以通过该 API 将商家设置为 CLOSED_TEMPORARILY。了解详情。

v4.5

新功能

通过 Pub/Sub 了解问答信息
现在，您可以接收 Google Cloud Pub/Sub 通知，了解有关某个营业地点的新的/更新后的问答信息。了解详情。
通过 Pub/Sub 了解商家信息状态
现在，您可以接收 Google Cloud Pub/Sub 通知，了解商家信息状态方面的变化。了解详情。

v4.4

新功能

本地服务商家验证
现在，该 API 可以验证本地服务商家。了解详情。
关注者数量
现在，您可以检索有关关注者的元数据。了解详情。
用户群组和营业地点组
现在，可以通过该 API 创建用户群组和营业地点组。了解详情
LocationState 中添加了 hasPendingEdits 字段
用于指明某个营业地点的属性是否处于"修改内容正在等待审核"状态。了解详情

行为更改

开业日期
现在，您可以为商家信息设置一个将来的开业日期。
PointRadius
PointRadius 现在处于只读状态。修改或创建本地服务商家需要使用 Places。

v4.3

新功能

问答 API
检索有关您的营业地点的问题、发布回答，并提供常见问题解答。了解详情。
批量阅读评价
通过一次调用检索对多个营业地点的评价。了解详情。
推荐的 GoogleLocation
查看 Google 认为可能归您所有、但未声明所有权的营业地点。了解详情。
报告 GoogleLocation 问题
报告有关 RecommendedGoogleLocations 或 GoogleLocations 结果的问题。了解详情。
PriceList 部分的服务枚举
将 PriceList 部分标识为包含所提供的 FOOD 项或 SERVICES。了解详情。
媒体说明
在上传新媒体时提供说明。了解详情。
CHAINS_QUERIES 数据分析
检索某个营业地点因用户搜索其所属的连锁店而获得的展示次数。了解详情。

行为更改

有关组织帐号和营业地点组的通知
配置了 Pub/Sub 通知的帐号现在也会收到有关由它们担任管理员的组织帐号或营业地点组内所含的任何商家信息的通知。
ListLocations（适用于组织帐号和营业地点组）
现在，使用某个用户群组或组织帐号调用的 accounts.locations.list 会显示该帐号可以访问的所有营业地点。

v4.2

新功能

验证 API
针对未验证的营业地点列出并触发可用的验证方法。了解详情。
GoogleLocations API
在 Google 上搜索现有的营业地点以声明对其的所有权，或者检索相应链接以请求访问已声明所有权的营业地点。了解详情。
扩展的营业地点过滤条件
用于限制从 Locations.List 调用返回的结果的更多选项。了解详情。
连锁店成员资格
指明某个营业地点是否隶属于某连锁品牌（如 Walmart 和 Target 等）。了解详情。
组织信息
组织帐号的相关信息现在会显示在 Account 对象中。了解详情。
评价者个人资料照片
评价者个人资料照片的网址现在会包含在 review 对象中。了解详情。

v4.1

新功能

客户提供的媒体
现在，您可以针对您拥有和管理的营业地点，检索和查看其用户生成照片和视频的数据分析。了解详情。
管理员管理 API
现在，您可以为您的帐号列出、接受和拒绝与帐号和营业地点相关的邀请。了解详情。
Profile（商家提供的说明）
利用极具个性色彩的语言描述您的商家，并与用户分享您的商家和服务的独特故事。了解详情。
openingDate 字段
提供您的营业地点开始营业的日期。了解详情。
优惠类型帖子
一种新的 Google 信息帖类型，可帮助用户查找您的营业地点提供的特惠活动。了解详情。

v4

新功能

Google 信息帖
现在，您可以直接通过该 API 创建 Google 信息帖。
照片上传
除了现有的网址上传，现在还可以通过该 API 直接上传照片。
通知过滤/选择接收
现在，您可以过滤要将哪些通知发送到 Pub/Sub 主题。未来的通知将使用此机制来选择接收，而不是发送给所有用户。
UPDATED_REVIEW 通知
现在，您可以订阅实时通知，获知最新的客户评价。
对用户群组的支持
Google My Business API 现在支持用户群组类型的帐号。

向后不兼容的更改

  • 照片（以前是 location 对象字段）现在是营业地点下的一项资源 (accounts/account_ID/locations/location_ID/photos)。

  • 地址字段 Country 现在是 region_code，而 sub_locality 现在是 sublocality。

  • 移除了之前已弃用的 Ownership 字段。

  • 以前，帐号和营业地点的共同所有者与主要所有者无法通过该 API 区分（均显示为 OWNER）。现在，主要所有者将具有 OWNER 角色，而其他所有者将具有 CO_OWNER 角色。

  • AccountType.BUSINESS 现在称为 AccountType.LOCATION_GROUP。

  • 使用字段掩码更新营业地点时，需提供 update_mask 来代替现有的 field_mask。

  • 用于 primary_category 和 additional_categories 的类别消息不再包含用户可理解的形式。用户应使用 Google My Business API 的类别服务来获取已经过转换的用户可理解的类别名称。

v3.3

新功能

结构化菜单

现在，您可以执行以下操作：

  • 针对指定营业地点添加、更新或删除多个菜单

  • 在菜单中添加多个菜单版块

  • 列出菜单项的名称、说明、价格和照片

v3.2

新功能

数据分析
现在，您可以通过该 API 检索营业地点数据分析和行车指标。
通知
现在，您可以订阅有关新 Google 更新的实时通知。

向后不兼容的更改

  • 移除了 UrlAttributeValue 中之前未使用的 languageCodes 和 platforms 字段。

  • 已弃用的所有权枚举中的 SAME 现在仅在复制的营业地点具有相同的主要所有者时才适用。以前，该行为基于更复杂的所有权计算。

v3.1

新功能

通知
现在，您可以订阅有关新评价的实时通知。
地图网址
Google 地图网址包含在营业地点响应中，支持用户轻松链接到 Google 地图。
营业地点状态
表明商家信息何时发布、停用及待验证的其他营业地点状态。
重新营业标记
canReopen 标记用于区分可重新营业的永久停业地点以及不可重新营业的永久停业地点。
属性
支持网址和枚举属性。
类别端点
按国家/地区和语言获取支持的类别列表（替换 CSV 文件）。

v3

新功能

评价
现在，您可以通过该 API 检索商家评价并进行回复。
属性
提供关于营业地点的其他类别专用信息。
查找匹配的营业地点
查找地图上现有的营业地点，并手动将其与您的营业地点相关联。
转移营业地点
针对 Location :transfer 的新操作。允许将营业地点从一个帐号（商家帐号或个人帐号）转移到另一个帐号。
首选照片
指明您希望最先在 Google 地图和 Google 搜索中显示的照片。
新的搜索过滤条件
新的搜索过滤条件包括 any_google_updates、is_suspended 和 is_duplicate。
新的营业地点状态
现在，营业地点状态也包括 is_verified 和 needs_reverification。
照片网址改进
现在，该 API 接受没有图片格式后缀的照片网址。

向后不兼容的更改

  • 现在，只能为具有 Google+ 信息页的营业地点更新照片（这些照片之前可以接受，并且会被静默删除）。

  • 现在，location_name 和 category_name 字段只是输出。仅在设置类别时才使用类别 ID。

  • 字段掩码不应再包含所含字段的 location. 前缀。

  • 现在，创建/更新操作将营业地点作为正文载荷；其他参数会移动到查询字符串中。

v2

向后不兼容的更改

  • 现在，您必须在 CreateLocation 调用中指定 request_id。对于每个营业地点，此 ID 必须是唯一的；这有助于避免在帐号中创建重复的营业地点。如果尝试创建的营业地点的请求 ID 与先前创建的营业地点匹配，则仅会返回现有的营业地点，不会在帐号中创建重复的营业地点。

    • Location 中的 business_hours 已重命名为 regular_hours。