Method: locations.verify

開始特定地點的驗證程序。

HTTP 要求

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。待驗證地點的資源名稱。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
欄位
method

enum (VerificationMethod)

必要欄位。驗證方法。
languageCode

string

選用設定。BCP 47 語言代碼，代表驗證程序採用的語言。
context

object (ServiceBusinessContext)

選用設定。用於驗證服務商家的額外背景資訊。只有商家類型為 CUSTOMER_LOCATION_ONLY 的地點才需要提供這個屬性。地址驗證會用來傳送明信片，其他方法應與傳遞至 GetVerificationOptions 的方法相同。如果將 INVALID_src 設為其他商家地點類型，就會擲回。
聯集欄位 RequestData。除了顯示資料以外，使用者為特定方法輸入的資料。資料必須與要求的方法相符。如果不需要任何資料，請將此欄位留空。RequestData 只能是下列其中一項：
emailAddress

string

選用設定。EMAIL 方法的輸入內容。要接收 PIN 碼的電子郵件地址。

系統僅接受 locations.fetchVerificationOptions 中輸入的電子郵件地址。如果 [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] 已將 isUserNameEditable 設為 true，客戶可以指定不同的使用者名稱 (local-part)，但必須與網域名稱相符。
mailerContact

string

選用設定。ADDRESS 方法的輸入內容。收件者名稱。
phoneNumber

string

選用設定。PHONE_CALL/SMS 方法的輸入欄位：應撥打或接收簡訊的電話號碼。必須是符合資格選項中的其中一組電話號碼。
token

object (VerificationToken)

選用設定。VETTED_PARTNER 方法的輸入內容，可供選取「合作夥伴」使用。未通過審查的帳戶則不需要輸入。與位置相關聯的權杖。與位置相關聯的權杖。

回應主體

Verifications.VerifyLocation 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "verification": {
    object (Verification)
  }
}
欄位
verification

object (Verification)

已建立的驗證要求。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

VerificationToken

認證合作夥伴產生的權杖。

JSON 表示法 
{
  "tokenString": string
}
欄位
tokenString

string

憑證字串。