常见问题解答

什么是 GBP API?

Google 商家资料 (GBP) API 是一种编程接口,可让开发者通过编写应用来管理其商家资料账号和营业地点数据。借助此类 API,商家或其代表可以管理自己的数据在各项 Google 产品和服务中的显示方式,并控制谁可以共同管理其数据。用户创建的数据(例如照片、帖子和评价)也可以通过此类 API 进行管理。

商家资料 API 提供了商家资料界面的几乎所有功能,此外还提供了一些此类 API 特有的功能。此类 API 的用户可以像商家资料界面的用户一样获得 Google 更新。

哪些人可以访问 GBP API?

GBP API 不向公众开放。用户需要请求对 GBP API 的访问权限才能使用它们。个人或公司只要能够证明自身出于合法商业目的需要访问 GBP API,其权限请求即可获得批准。以下是关于证明商家合法性的两条建议:

  • 使用与商家域名关联的有效商家电子邮件地址。
  • 确保商家网站上的内容是最新的,而且网站能够正常运行。

用户能够访问 GBP API 是否意味着其可以查询任何 Google 商家资料数据?

不是。如果您无法访问特定的 Google 商家资料,即使您可以访问 GBP API,也无法查询相应的 Google 商家资料数据。

GBP API 用户需要遵守哪些相关政策?

合作伙伴需要遵守 Google 商家资料政策,以及所有 API 政策条款及条件

用户如何获取对 GBP API 的访问权限?

若要成功创建您的第一个客户端应用,您必须满足以下前提条件:

  1. 获取 Google 账号
  2. 试用商家资料
  3. 在 Google API 控制台中创建项目
  4. 请求 API 访问权限:请求将在 14 天内审核完毕。

用户如何获取对 GBP API 中某个特定 API 的访问权限?

您必须在 Google API 控制台中启用以下 8 个与商家资料相关联的 API:

  • Google My Business API 4.9,包括 API 调用的以下重要功能:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • My Business Business Information API
  • My Business Q&A API
  • Business Profile Performance API

访问权限申请获得批准后,用户将获得涵盖所有 8 个 API 的标准默认配额。

GBP API 访问权限是怎样授予的?

GBP API 访问权限是在 Google Cloud 项目级授予的。如果用户 A 针对编号为 12345678 的项目申请 Google 商家资料 API 访问权限,那么将针对编号为 12345678 的项目授予访问权限。因此,有权访问该 Google Cloud 项目的任何用户(包括用户 A)都可以调用 Google 商家资料 API。合作伙伴必须根据访问需求控制对 Google Cloud 项目的访问权限,以避免滥用。

能否提供此类 API 和示例功能的摘要?

请参阅下表了解不同的 API 及其功能。

API 参考文档 示例功能
Account Management API 文档
  • 管理对营业地点的访问权限。
  • 在指定的父账号下以指定的账号名称和类型创建账号。
  • 列出经过身份验证的用户的所有账号。
  • 列出指定账号的待处理邀请。
  • 将营业地点从用户名下的一个账号移至另一个账号。
  • 更新指定营业地点的管理员信息。
Business Information API 文档
  • Business Information API 可用于管理商家资料生命周期,以及在 GBP 上添加或管理商家信息。
  • 让商家可以获取、创建、更新或删除 Google 商家资料。
  • 让商家可以获取或更新商家资料属性。
  • 让商家可以获取或搜索连锁店、商家资料类别。
Lodging API 文档
  • 用于管理商家在 Google 上与住宿相关的数据,例如房源设施及政策。此 API 适用于提供住宿服务的商家,例如酒店。开发者可通过 Lodging API 更新 Google 商家资料的住宿属性。
Place Actions API 文档
  • 用于管理商家的地点操作链接。
  • 可重定向用户,以执行预约、订位、订外卖等操作。
Notifications API 文档
  • 用于管理指定账号的通知设置。
Verifications API 文档
  • 为营业地点启动验证流程。
  • 报告某个营业地点使用特定语言的所有符合条件的验证选项。
Q&A API 文档
  • 用于管理有关营业地点的问题和答案。
Business Profile Performance API 文档
  • 让商家可以提取其在 Google 上的商家信息的效果分析数据。
  • 分析数据包括商家展示次数、路线查询次数、点击致电次数、网站点击次数、预订次数、订餐次数、菜单互动次数等。
Media API 文档
  • 让 API 开发者可以为商家资料上传照片和视频。
Reviews API 文档
  • 让商家可以获取和回复商家资料获得的评价。
Local Posts API 文档
  • 让商家可以获取、创建或更新本地帖子。
FoodMenus API 文档
  • 让商家可以获取、创建或更新商家资料中的食品菜单。

如果您对可供自己使用的数据和/或如何访问这些数据仍有疑问,请使用此表单

合作伙伴应如何设置账号结构以使用 GBP API?

如果您是代表商家管理商家信息的第三方合作伙伴,请做到以下几点:

商家如何授权 GBP API 合作伙伴管理其商家信息?

商家可以通过以下两种方式向第三方合作伙伴授予访问权限:

  • OAuth 设置:参阅这份指南,了解第三方合作伙伴平台如何使用商家凭据代表商家或企业修改和访问 Google 商家资料数据。
  • 所有者或管理员访问权限:如果商家(应是 GBP 的主要所有者)将第三方合作伙伴添加为 Google 商家资料的管理员,那么第三方合作伙伴无需使用商家凭据即可使用 GBP API 修改和访问 GBP 数据。

    注意:我们强烈建议第三方合作伙伴不要将自己添加为 GBP 的所有者,而只将自己添加为管理员。

如果商家的营业地点超过 10 个,是否可以进行批量验证?

可以。您可以申请对 10 个以上营业地点进行批量验证。通过验证后,您可以使用商家资料 API 管理已发布的连锁营业地点,具体方式与管理其他营业地点相同,但也有一些例外情况。例如,营业地点管理员的权限不同,他们可以将自己添加到特许经营地点。

各种 API 的配额限制分别是多少?

用量限额中列出了标准配额限制。如果您需要更高的限额,可以提交标准配额请求

我可以申请多少配额?

配额是有限资源。GBP API 支持团队会确认您过去的配额用量,然后据此确定您是否符合增加配额的资格。如果您的平均配额用量低于当前配额限制的 70%,支持团队就会拒绝您进一步提高配额限制的申请。

GBP API 合作伙伴能否针对生产环境创建测试账号?

不能。很遗憾,无法直接通过 GBP 界面或 API 在生产环境中创建虚假的 GBP 商家信息,并对其进行测试。

大多数虚假商家信息都会被我们的审核系统标记并暂停。我们建议使用客户端中的商家信息并在非工作时间使用(但不要更改商家信息的任何主要信息,例如名称、地址、类别等),也可以根据公司总部地点创建商家信息。如果您想测试 API 响应,以验证商家信息或任何其他需要正式版商家信息的操作,可以使用模拟 API 响应