常见问题解答

什么是 GBP API？

Business Profile API 是一种编程接口，可让开发者编写应用来管理其商家资料账号和营业地点数据。借助这些 API，商家或其代表可以管理其数据在 Google 上的显示方式，并控制谁可以共同管理其数据。用户创建的数据（例如照片、帖子和评价）也可以通过 API 进行管理。

Business Profile API 提供与商家资料界面几乎相同的功能，此外还有一些 API 特有的功能。此类 API 的用户可以像 Google 界面用户一样获得 Google 更新。

谁可以使用 GBP API？

GBP API 未向公众开放。用户必须申请 GBP API 的访问权限才能使用它们。任何能够证明访问 GBP API 的合法业务理由的个人或公司都将获得访问批准。下面几条建议有助于证明企业的合法性：

  • 请使用与您的企业域名相关联的有效企业电子邮件地址。
  • 确保商家网站已更新且有效。

如果用户能够访问 GBP API，是否可以查询任何 Google 商家资料数据？

不可以。即使您可以访问 GBP API，也无法查询 Google 商家资料数据，除非您有权访问相应的 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 问答 API
  • Business Profile Performance API

如果用户请求访问权限的应用获得批准，系统会为其授予全部八个 API 的标准默认配额。

如何访问 GBP API？

GBP API 访问权限是在 Google Cloud 项目级授予的。如果用户 A 为项目 # -12345678 申请了 Google Business Profile API 访问权限，则项目 # -12345678 将获得访问权限。因此，任何用户（包括有权访问 Google Cloud 项目的用户 A）都可以调用 Google Business Profile 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 文档
  • 启动营业地点的验证流程。
  • 针对某个营业地点使用特定语言报告所有符合条件的验证选项。
问答 API 文档
  • 允许管理营业地点的问题和解答。
Business Profile Performance API 文档
  • 让商家可以提取有关其在 Google 上的商家信息的效果数据分析。
  • 数据分析包括商家展示次数、路线查询次数、点击致电次数、网站点击次数、预订次数、订餐次数、菜单互动次数等。
媒体 API 文档
  • 允许 API 开发者为商家资料上传照片和视频。
Reviews API 文档
  • 允许商家在商家资料中获取评价并回复评价。
Local Posts API 文档
  • 允许商家获取、创建或更新本地帖子。
FoodMenus API 文档
  • 允许商家获取、创建或更新商家资料的食品菜单。

合作伙伴应如何设置其账号结构，才能使用 GBP API？

如果您是为商家执行商家信息管理的第三方合作伙伴：

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

企业可通过以下两种方式向第三方合作伙伴授予访问权限：

  • OAuth 设置：请参阅本指南 ，了解第三方合作伙伴平台如何使用商家凭据代表商家或商家修改和访问 Google 商家资料数据。

  • 所有者或管理员访问权限：如果商家将第三方合作伙伴添加为 Google 商家资料的管理员，而商家应该是 GBP 的主要所有者，则第三方合作伙伴无需使用商家凭据即可使用 GBP API 修改和访问 GBP 数据。

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

如果商家有 10 个以上的营业地点，是否可以进行批量验证？

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

各种 API 的配额限制是多少？

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

我可以申请多少配额？

配额是有限的资源。GBP API 支持团队会确认您过去的配额使用情况，以确定您的配额增加申请资格。如果您的平均配额使用量低于当前配额限制的 70%，我们可能会拒绝您进一步提高配额限制。

GBP API 合作伙伴能否创建用于生产环境的测试账号？

不可以。遗憾的是，目前无法通过 GBP 界面或 API 在生产环境中创建虚假的 GBP 商品详情并针对其进行测试。

大多数创建的虚假商家信息都会被我们的审核部门举报并被暂停。建议您使用客户商家信息，并在非工作时间进行使用（前提是您没有更改商家信息的任何主要信息，例如名称、地址、类别），或者为公司总部创建商家信息。如果您想要测试 API 响应以验证商家信息或任何其他需要生产商家信息的操作，则可以使用模拟 API 响应。