直接在其平台上提供商家信息管理功能的提供商可以验证商家的商家信息, 投放广告这样就无需将商家重定向到 商家资料界面。
获取当前状态
用户可以拨打 locations.getVoiceOfMerchantState
以检索其当前状态。如果
hasVoiceOfMerchant
布尔值为 true
,则表示营业地点已经信誉良好,无需采取任何其他操作。否则,如果响应中的 gain_voice_of_merchant
操作包含 verify
,您必须完成验证。如需了解详情,请按照以下说明操作。
提取验证选项
提供商可以使用
locations.fetchVerificationOptions
提示商家从可用列表
验证方法。
要获取验证选项,请使用以下代码:
<ph type="x-smartling-placeholder">POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
启动验证流程
选择验证方法后,请开始验证流程。
locations.verify
。
完成此调用后,相应营业地点会变为已验证状态或返回错误状态。
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
检索当前验证
通过
locations.verifications.list
call 会检索验证请求历史记录及其在通话中所指定营业地点的状态。
如需检索所有验证请求,请使用以下命令:
<ph type="x-smartling-placeholder">GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
完成待处理的验证
PIN 码和
locations.verifications.complete
方法通常需要使用 方法完成商家验证。
如需完成待处理的验证,请使用以下工具:
<ph type="x-smartling-placeholder">POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
使用 API 进行 GBP 验证的最佳做法
营业地点创建
借助 GBP Business Information API,您可以嵌入自己的平台来提供营业地点创建功能。当您要求商家添加新的营业地点时,请务必按以下步骤操作:
从商家收集商家名称、地址和类别等营业地点信息。
- 调用
googleLocations.search
端点。 - 在 API 请求中提供营业地点数据,例如商家名称、类别、地址、电话号码和网站。
另外,您也可以按照以下步骤搜索可能匹配的地理位置:
- 查询可能的位置匹配项。
- 请商家选择正确的营业地点。
- 如果营业地点响应中包含
requestAdminRightsUrl
,请帮助商家在 Google 商家资料中请求对该营业地点的访问权限和所有权。 - 如果
requestAdminRightsUrl
不存在,请使用营业地点响应中的地点 ID 创建新的营业地点。 - 验证新的营业地点。
注意:如果初始查询中没有任何可能的营业地点匹配项,请使用空白的地点 ID 创建新的营业地点。然后,验证该新营业地点。
营业地点验证
若要使用 GBP API 开始验证流程,请按以下步骤操作:
- 调用
accounts.locations.list
方法,列出 Google 账号的所有营业地点。 - 选择要验证的营业地点。
- 调用
GetVoiceOfMerchant
API 方法,确认该营业地点是否需要验证。 - 如果响应返回 verify,则调用
fetchVerificationOptions
,以获取可用于验证该营业地点的方法列表。 - 仔细检查
verificationOption
数据是否包含正确的地址、电话号码和电子邮件地址。 - 在该技工选择最佳验证选项后,调用
locations.verify
方法启动适当的验证。如需确认启动是否正在进行,请调用locations.verifications.list.
- 使用商家的 PIN 码调用
locations.verification.complete
方法。 - 调用
GetVoiceOfMerchant
API 方法。如果状态为HasVoiceOfMerchant = true
,则表示您已成功验证该营业地点。
注意:如果营业地点可以使用 AUTO
验证,商家无需执行任何验证步骤
如需详细了解 GBP 验证,请参阅我们的帮助中心支持文章。