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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
フィールド
method

enum (VerificationMethod)

必須。確認方法。

languageCode

string

省略可。確認プロセスで使用される言語を表す BCP 47 言語コード。

context

object (ServiceBusinessContext)

省略可。サービス ビジネスの確認に関する追加のコンテキスト情報。これは、ビジネスタイプが CUSTOMER_LOCATION_ONLY のビジネス情報にのみ必要です。住所確認の場合、住所はハガキの送付に使用されます。その他の方法の場合は、GetVerificationOptions に渡されるものと同じにする必要があります。他のタイプのビジネス拠点に設定されている場合は、INVALID_ARGUMENT がスローされます。

表示データに加えて、特定のメソッドのユーザー入力データ。データは、リクエストされたメソッドと一致している必要があります。データが不要な場合は空白のままにします。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
emailAddress

string

省略可。EMAIL メソッドの入力。PIN の送信先となるメールアドレス。

メールアドレスは、locations.fetchVerificationOptions で提供されるアドレスのいずれかである場合にのみ受け入れられます。[EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] で isUserNameEditable が true に設定されている場合、クライアントは別のユーザー名(ローカル部分)を指定できますが、ドメイン名と一致している必要があります。

mailerContact

string

省略可。ADDRESS メソッドの入力。メールの送信先となる連絡先の名前。

phoneNumber

string

省略可。PHONE_CALL / SMS メソッドの入力。電話をかけるか SMS を送信する電話番号。利用可能なオプションの電話番号のいずれかである必要があります。

token

object (VerificationToken)

省略可。VETTED_PARTNER メソッドの入力は、一部のパートナーのみが利用できます。審査済みのアカウントの場合、入力は不要です。場所に関連付けられているトークン。場所に関連付けられているトークン。

trustedPartnerToken

string

TRUSTED_PARTNER メソッドの入力。ビジネス情報に関連付けられているオーナー確認トークン。

相互に排他的なフィールドの終了。

レスポンスの本文

Verifications.VerifyLocation のレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "verification": {
    object (Verification)
  }
}
フィールド
verification

object (Verification)

作成された検証リクエスト。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。

VerificationToken

審査済みのパートナーによって生成されたトークン。

JSON 表現
{
  "tokenString": string
}
フィールド
tokenString

string

トークン文字列。