Verification API 和 Business Information API 现已发布!必须执行迁移工作。要了解有关已弃用端点的详细信息,请参阅我们的弃用时间表。您还可以注册加入我们的邮寄名单,以便接收最新动态。

管理验证

直接在其平台上提供商家信息管理功能的提供商可在自己的网站上对商家信息进行验证。无需将商家重定向到“Google 我的商家”界面即可进行验证。

获取当前状态

用户可以调用某营业地点的 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"
}