Method: verificationTokens.generate

为提供的位置数据生成令牌,以验证位置。

HTTP 请求

POST https://mybusinessverifications.googleapis.com/v1/verificationTokens:generate

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationId": string
  // End of mutually exclusive fields.
}
字段
要为其生成即时验证令牌的位置信息。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
locationId

string

与未验证的商家信息相关联的营业地点标识符。

这是在最初创建商品详情时生成的地理位置 ID。它是 Business Information API 生成的营业地点资源名称的最后一部分。

注意:来电者必须是此商家信息的所有者或管理员,才能生成验证令牌。

如需了解详情,请参阅位置资源文档。

互斥字段结束。

响应正文

Verifications.GenerateInstantVerificationToken 的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "result": enum (Result),
  "instantVerificationToken": string
}
字段
result

enum (Result)

仅限输出。即时验证令牌生成结果。

instantVerificationToken

string

生成的即时验证令牌。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/business.manage

如需了解详情,请参阅 OAuth 2.0 Overview。

结果

枚举
RESULT_UNSPECIFIED 默认值,会导致错误。
SUCCEEDED 即时验证令牌已成功生成。
FAILED 未生成即时验证令牌。