注意:此 API 的 v4.7 版本已发布!请参阅更新日志。仍暂时允许在链中提供与新冠肺炎 (COVID-19) 相关的帖子。

管理验证

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

下图简要介绍了验证流程:

图 1:“Google 我的商家”营业地点验证流程的泳道图。

获取当前验证状态

用户可以调用某营业地点的 accounts.locations.get,以检索其当前状态。如果 location.LocationState.isVerified 布尔值为 true,则表示相应营业地点信息已通过验证。否则,请按照下文中的步骤验证该营业地点。

获取验证方式

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

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

启动验证流程

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/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"
  }
}

检索当前验证

accounts.locations.verifications 调用会检索该调用中所指定营业地点的当前验证状态和历史记录。

如需检索当前验证,请使用以下代码:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

完成未完成的验证

有时需要通过 PIN 码和 accounts.locations.verifications.complete 方法才能完成对商家信息的验证。

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}