注意: チェーンによる 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"
    }