ビジネスのオーナー確認プロセスを開始します。
HTTP リクエスト
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
name |
必須。オーナー確認を行うビジネスのリソース名。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "method": enum ( |
| フィールド | |
|---|---|
method |
必須。確認方法。 |
languageCode |
省略可。確認プロセスで使用される言語を表す BCP 47 言語コード。 |
context |
省略可。サービス ビジネスの確認に関する追加のコンテキスト情報。これは、ビジネスタイプが CUSTOMER_LOCATION_ONLY のビジネス情報にのみ必要です。住所確認の場合、住所はハガキの送付に使用されます。その他の方法の場合は、GetVerificationOptions に渡されるものと同じにする必要があります。他のタイプのビジネス拠点に設定されている場合は、INVALID_ARGUMENT がスローされます。 |
| 表示データに加えて、特定のメソッドのユーザー入力データ。データは、リクエストされたメソッドと一致している必要があります。データが不要な場合は空白のままにします。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。 | |
emailAddress |
省略可。EMAIL メソッドの入力。PIN の送信先となるメールアドレス。 メールアドレスは、locations.fetchVerificationOptions で提供されるアドレスのいずれかである場合にのみ受け入れられます。[EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] で isUserNameEditable が true に設定されている場合、クライアントは別のユーザー名(ローカル部分)を指定できますが、ドメイン名と一致している必要があります。 |
mailerContact |
省略可。ADDRESS メソッドの入力。メールの送信先となる連絡先の名前。 |
phoneNumber |
省略可。PHONE_CALL / SMS メソッドの入力。電話をかけるか SMS を送信する電話番号。利用可能なオプションの電話番号のいずれかである必要があります。 |
token |
省略可。VETTED_PARTNER メソッドの入力は、一部のパートナーのみが利用できます。審査済みのアカウントの場合、入力は不要です。場所に関連付けられているトークン。場所に関連付けられているトークン。 |
trustedPartnerToken |
TRUSTED_PARTNER メソッドの入力。ビジネス情報に関連付けられているオーナー確認トークン。 |
| 相互に排他的なフィールドの終了。 | |
レスポンスの本文
Verifications.VerifyLocation のレスポンス メッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{
"verification": {
object ( |
| フィールド | |
|---|---|
verification |
作成された検証リクエスト。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/business.manage
詳細については、OAuth 2.0 Overview をご覧ください。
VerificationToken
審査済みのパートナーによって生成されたトークン。
| JSON 表現 |
|---|
{ "tokenString": string } |
| フィールド | |
|---|---|
tokenString |
トークン文字列。 |