请在关键端点停用之前更新您的 Google Business Profile API 集成。请查看
弃用时间表和相关说明,以免在 2022 年 4 月之后出现中断。
GoogleLocations
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 GoogleLocations API,您可以提前了解是否已经有人在商家资料中声明了对某个营业地点的所有权。这样,如果已经有人声明了对该营业地点的所有权,您可以立即请求对该营业地点的访问权限。此外,如果您管理批量验证的帐号,则可以提前更准确地选择可能的匹配项,并避免创建重复的营业地点。
该 API 端点会返回一个网址,用于指明是否已经有人声明了对某个营业地点的所有权。如果已有人声明所有权,您可以使用同一网址启动访问权限请求流程。
下图简要介绍了获取营业地点所有权的过程。
您可以按照以下步骤使用 GoogleLocations
API:
- 从商家收集营业地点数据。
-
调用 googleLocations.search
端点。在调用的正文中提供营业地点数据。或者,您可以通过查询字符串提供这一数据,类似于用户在 Google 搜索或 Google 地图中输入的内容。例如,“Starbucks 5th ave NYC”。
该 API 会返回可能匹配的营业地点列表以及每个营业地点的相关信息,例如 locationName
和地址。
- 选择与您的营业地点匹配的营业地点。如果没有匹配项,请调用
accounts.locations.create
,然后跳到第 5 步。
-
根据响应中 requestAdminRightsUrl
的状态,执行以下操作:
- 如果存在
requestAdminRightsUrl
,则表明另一位用户拥有该商家信息的所有权。请将商家定向至该网址,以开始在商家资料中请求对现有营业地点的访问权限以及所有权。
- 如果
requestAdminRightsUrl
不存在,请调用 accounts.locations.create
并创建新的商家信息,我们稍后将会对这些商家信息进行验证。
- 如果您在这一过程中创建了新的商家信息,则可以利用验证 API 开始验证这些商家信息。有关详情,请参阅管理验证。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2022-08-03。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]