ビジネス プロフィールからビジネス情報をオンボーディングする

ビジネス プロフィールは、Google 検索や Google マップなど、Google サービスでのオンライン プレゼンスを簡単に管理できる、企業と組織向けの無料ツールです。

Google Business Profile API は、Google でビジネス情報を管理するためのインターフェースを提供します。あるビジネスでは、OAuth 同意を通して、他のビジネスのために自身のプロフィールを管理するビジネスにアクセス権を付与できます。

ビジネス プロフィールの管理対象ビジネスは、ビジネス プロフィールのオーナー確認プロセスですでにオーナー確認済みです。ビジネス プロフィールの OAuth 同意フローを拡張して、これらのビジネスをビジネス メッセージにオンボーディングし、ビジネスのオーナー確認を行ってビジネス メッセージで開始できます。

ビジネス メッセージを起動する方法としては、スケーラブルかつ迅速です。ビジネス プロフィールの場所でメッセージ機能を有効にする場合に推奨されるフローです。

Prerequisites

Google Business Profile API にアクセスできる既存のビジネス プロフィール パートナーである必要があります。アクセス権がない場合は、ビジネス プロフィールの前提条件に沿ってアクセス権を申請してください。

Google Business Profile API へのアクセス権が付与されたら、基本設定ガイドと OAuth 設定ガイドに従って続行してください。

オーナー確認済みのビジネス プロフィールのビジネス情報で、ビジネス メッセージを有効にする

次の図は、ウェブサービスでビジネス メッセージ エージェント向けのブランドのビジネス プロフィールのオーナー確認を利用する方法を示しています。詳細な手順については、以下をご覧ください。

ビジネス プロフィールのオーナー確認を使って、エージェントを自動的に確認するためのフロー図

  1. ビジネス プロフィールのアカウント所有者に代わって Google ビジネス プロフィール API の呼び出しを許可する既存の OAuth 同意フローで、API スコープを更新して以下を含めます。

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

    エージェントとビジネスの場所を自動的に検証するには、両方のスコープが必要です。

  2. エージェントを作成し、displayName を指定して、前の手順で取得した OAuth 認証情報が所有する Google ビジネス プロフィールのリスティングのうち、少なくとも 1 つの名前を確認します。Google Business Profile API でビジネス情報を検索し、ビジネスの名前を見つけます。

    名前の照合:

    • 大文字と小文字は区別されません。
    • エージェントの完全な名前は、ビジネス プロフィールの地域名に含まれる最初の単語と完全に一致している必要があります。たとえば、「GBP Bakery」という名前のエージェントは「Gbp Bakery Mountain View」、「Gbp Bakery」、「gbp bakery sunnyvale」と一致しますが、「Bakery San Francisco」とは一致しません。

  3. ビジネス プロフィールのビジネス情報ごとに、同じ placeId を使用してビジネス情報を作成します。ビジネス プロフィールのビジネス情報に関する placeId は、Google Business Profile API からビジネス情報を取得する際に、LocationKey オブジェクト内に含まれます。

  4. 作成したエージェントと取得した OAuth トークンを使用して、エージェントの確認をリクエストします。

    この確認リクエストには、ブランドの連絡先情報が必要です。ただし、エージェント名がビジネス プロフィール名と一致し、正しいスコープで OAuth トークンを取得した場合、確認プロセスからブランドにメールが送信されます。

    これが正しく行われた場合、検証リクエストの出力により、すぐに VERIFICATION_STATE_VERIFIED の verificationState が返されます。verificationState が異なる値を返す場合、リクエスト時に正しい OAuth トークンを使わなかったか、エージェントがビジネス プロフィールのビジネス情報と一致しなかった可能性があります。

  5. 同じ OAuth トークンを使用して、ビジネス プロフィールでビジネスが所有するすべてのビジネス情報のビジネスのオーナー確認をリクエストします。

    エージェントの確認と同様に、これを正しく行うと、検証リクエストの出力からすぐに VERIFICATION_STATE_VERIFIED の verificationState が返されます。verificationState が異なる値を返す場合、リクエスト時に正しい OAuth トークンを使用しなかったか、ビジネス プロフィールのビジネス情報が申請され、オーナー確認が済んでいない可能性があります。

  6. エントリ ポイント LOCATION を使用してエージェントを起動します。

  7. Google 検索と Google マップから利用できるようにしたいビジネス情報をリリースすることで、特定のビジネス情報のメッセージを有効にできます。起動プロセスが開始されると、起動した各ロケーションのメッセージは数時間以内にユーザーに表示されるようになります。

上記の手順を行うと、すべてのコンシューマ メッセージが登録済みの Business Messages Webhook に送信され、Business Messages API を使用してユーザーにレスポンスを送信する必要があります。