Verifications API と Business Information API がリリースされました。移行作業が必要です。サポートが終了したエンドポイントについて詳しくは、サポート終了スケジュールをご覧ください。メーリング リストに登録して最新情報をお受け取りいただくこともできます。

オーナー確認の管理

プラットフォームで直接リスティング管理を提供しているプロバイダは、サイト内で販売者のビジネスのオーナー確認を行えるため、販売者を Google マイビジネスの管理画面にリダイレクトする必要がなくなります。

現在のステータスを取得する

ビジネス情報の locations.getVoiceOfMerchantState を呼び出して、現在のステータスを取得できます。If the hasVoiceOfMerchant のブール値が true の場合、ロケーションはすでに良好な状態にあり、追加の対応は必要ありません。レスポンスの gain_voice_of_merchant 操作に verify が含まれる場合は、検証を完了する必要があります。詳しくは、以下の手順に沿って操作してください。

オーナー確認オプションを取得する

プロバイダは locations.fetchVerificationOptions メソッドを使って、利用可能なオーナー確認方法のリストを販売者に提示し、希望の確認方法を選択するよう促すことができます。

オーナー確認オプションを取得するには、次のように記述します。

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

オーナー確認のプロセスを開始する

オーナー確認方法が選択されたら、locations.verify を使ってオーナー確認のプロセスを開始します。この呼び出しの結果として、ビジネスがオーナー確認済みのステータスに移行するか、エラー ステータスが返されます。

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

オーナー確認の成否を確認する

locations.verifications.list 呼び出しは、オーナー確認リクエストの履歴と、呼び出しで指定されたビジネスのステータスを取得します。

すべてのオーナー確認リクエストを取得するには、次のように記述します。

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

保留中のオーナー確認を完了する

通常、ビジネスのオーナー確認を完了するには、PIN コードと locations.verifications.complete メソッドが必要です。

保留中のオーナー確認を完了するには、次のように記述します。

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}