管理验证

如果提供商直接在其平台上提供商家信息管理功能,则可在自己的网站上验证商家信息,而无需将商家重定向到商家资料界面。

获取当前状态

用户可以调用某营业地点的 locations.getVoiceOfMerchantState,以检索其当前状态。如果 hasVoiceOfMerchant 布尔值为 true,则表示营业地点已经状态正常,无需采取任何其他操作。否则,如果响应中的 gain_voice_of_merchant 操作包含 verify,则必须完成验证。如需了解详情,请按照以下说明操作。

获取验证方式

提供商可以通过使用 locations.fetchVerificationOptions 方法来提示商家从支持的验证方式中选择首选联系方式。

如需获取验证方式,请使用以下代码:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

启动验证流程

选择验证方式之后,可以使用 locations.verify 启动验证流程。完成此调用后,相应营业地点会变为已验证状态或返回错误状态。

HTTP
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 调用会检索该调用中所指定营业地点的验证请求历史记录和验证状态。

如需检索所有验证请求,请使用以下命令:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

完成未完成的验证

完成商家验证通常需要 PIN 码和 locations.verifications.complete 方法。

如需完成未完成的验证,请使用以下代码:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

使用 API 进行 GBP 验证的最佳实践

营业地点创建

借助 GBP Business Information API,您可以嵌入自己的平台来提供营业地点创建功能。当您要求商家添加新营业地点时,请务必按照以下步骤操作:

从商家收集商家名称、地址和类别等营业地点信息。

  1. 调用 googleLocations.search 端点。
  2. 在 API 请求中提供营业地点数据,例如商家名称、类别、地址、电话号码和网站。

或者,您也可以按照以下步骤搜索可能匹配的营业地点:

  1. 查询可能匹配的营业地点。
  2. 请商家选择正确的营业地点。
  3. 如果营业地点响应中存在 requestAdminRightsUrl,则帮商家在 Google 商家资料中请求该营业地点的访问权限和所有权。
  4. 如果 requestAdminRightsUrl 不存在,则使用营业地点响应中的地点 ID 创建新的营业地点。
  5. 验证新的营业地点。

注意:如果初始查询没有找到任何可能匹配的营业地点,请使用空白的地点 ID 来创建新的营业地点。然后,验证这个新的营业地点。

营业地点验证

若要使用 GBP API 开始验证流程,请按以下步骤操作:

  1. 调用 accounts.locations.list 方法,列出 Google 账号的所有营业地点。
  2. 选择要验证的营业地点。
  3. 调用 GetVoiceOfMerchant API 方法,以确认该营业地点是否需要进行验证。
  4. 如果响应返回 verify,则调用 fetchVerificationOptions,以获取可用于验证该营业地点的方法列表。
  5. 仔细检查 verificationOption 数据是否包含正确的地址、电话号码和电子邮件地址。
  6. 商家选择最佳验证选项后,调用 locations.verify 方法以启动适当的验证。如需确认启动操作正在进行,请调用 locations.verifications.list.
  7. 使用商家的 PIN 码调用 locations.verification.complete 方法。
  8. 调用 GetVoiceOfMerchant API 方法。如果 HasVoiceOfMerchant = true,则表示您已成功验证该营业地点。

注意:如果营业地点可以使用 AUTO 验证,商家无需执行任何验证步骤

如需详细了解 GBP 验证,请参阅我们的帮助中心支持文章

适用于已通过审核的合作伙伴的验证方法指南