启动营业地点的验证流程。
HTTP 请求
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
要验证的营业地点的资源名称。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 | |
---|---|
{ "method": enum ( |
字段 | ||
---|---|---|
method |
验证方法。 |
|
languageCode |
BCP 47 语言代码,表示验证流程将采用的语言。 |
|
context |
用于验证服务类商家的额外背景信息。对于商家类型为 CUSTOMER_LOCATION_ONLY 的营业地点,则为必填。进行 ADDRESS 验证时,该地址将用于寄送明信片。其他方法应与传递给 locations.fetchVerificationOptions 的方法相同。如果针对其他类型的营业地点设置了 INVALID_STRING,则系统会抛出该错误。 |
|
联合字段 RequestData 。除显示数据之外,特定方法的用户输入数据。数据必须与请求的方法匹配。如果不需要任何数据,请将其留空。RequestData 只能是下列其中一项: |
||
emailInput |
EMAIL 方法的输入。 |
|
addressInput |
ADDRESS 方法的输入。 |
|
phoneInput |
PHONE_CALL/SMS 方法的输入 |
响应正文
如果成功,响应正文将包含结构如下的数据:
Verifications.VerifyLocation 的响应消息。
JSON 表示法 | |
---|---|
{
"verification": {
object ( |
字段 | |
---|---|
verification |
已创建验证请求。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
有关详情,请参阅 OAuth 2.0 概览。
EmailInput
用于进行 EMAIL 验证的输入。
JSON 表示法 | |
---|---|
{ "emailAddress": string } |
字段 | |
---|---|
emailAddress |
PIN 码应发送到的电子邮件地址。 仅当电子邮件地址为 locations.fetchVerificationOptions 提供的地址之一时,我们才会接受。如果 |
AddressInput
用于进行 ADDRESS 验证的输入。
JSON 表示法 | |
---|---|
{ "mailerContactName": string } |
字段 | |
---|---|
mailerContactName |
接收邮件的联系人姓名。 |
PhoneInput
PHONE_CALL/SMS 验证的输入。
JSON 表示法 | |
---|---|
{ "phoneNumber": string } |
字段 | |
---|---|
phoneNumber |
应接听来电或接收短信的电话号码。必须是符合条件的选项中的电话号码之一。 |