Method: locations.verify

ビジネスのオーナー確認プロセスを開始します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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_ARGUMENT がスローされます。
共用体フィールド 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 メソッドの入力。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

トークン文字列。