注意: チェーンによる COVID-19(新型コロナウイルス感染症)に関連する投稿が一時的に許可されています。また、Google マイビジネスは現在一部の機能を制限しています。一時的なサービスの変更に関する詳細をご確認ください。

オーナー確認の管理

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

次の図は、オーナー確認プロセスの概要を示しています。

図 1: ビジネスのオーナー確認を表すスイムレーン図

現在のオーナー確認ステータスを取得する

ビジネス情報の accounts.locations.get を呼び出して、現在のステータスを取得できます。location.LocationState.isVerified のブール値が true の場合、ビジネスのオーナー確認はすでに完了しています。そうでない場合は、次のセクションの手順に沿ってビジネスのオーナー確認を行ってください。

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

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

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

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

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/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"
  }
}

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

accounts.locations.verifications 呼び出しは、指定したビジネスの現在のオーナー確認状況と履歴を取得します。

現在のオーナー確認状況を取得するには、次のように記述します。

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

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

状況によっては、ビジネスのオーナー確認を完了するため、PIN コードと accounts.locations.verifications.complete メソッドを使用しなければならない場合もあります。

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}