開始地點驗證程序。
HTTP 要求
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
要驗證位置的資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 | |
---|---|
{ "method": enum ( |
欄位 | ||
---|---|---|
method |
驗證方法。 |
|
languageCode |
BCP 47 語言代碼,代表用於驗證程序的語言。 |
|
context |
服務商家驗證的額外背景資訊。對商家類型為「CUSTOMER_LOCATION_ONLY」的地點必填。如果是地址驗證,地址將用於寄送明信片。如果是其他方法,則應與傳遞至 location.fetchVerificationOptions 的方法相同。如果為其他類型的商家所在地點設定 INVALID_VALUE,則系統會擲回該字串。 |
|
聯集欄位 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
輸入電子郵件驗證
JSON 表示法 | |
---|---|
{ "emailAddress": string } |
欄位 | |
---|---|
emailAddress |
接收 PIN 碼的電子郵件地址。 系統只接受 location.fetchVerificationOptions 提供的其中一個地址電子郵件地址。如果 |
AddressInput
地址驗證的輸入內容。
JSON 表示法 | |
---|---|
{ "mailerContactName": string } |
欄位 | |
---|---|
mailerContactName |
要接收郵件的聯絡人姓名。 |
PhoneInput
PHONE_CALL/SMS 驗證的輸入內容。
JSON 表示法 | |
---|---|
{ "phoneNumber": string } |
欄位 | |
---|---|
phoneNumber |
應撥打或接收 SMS 的電話號碼。且必須是適用選項中其中一個電話號碼。 |