ビジネス プロフィールから店舗拠点をオンボーディングする

ビジネス プロフィールは、Google 検索や Google マップなど、Google サービス全体でビジネスや組織のオンライン プレゼンスを管理するための無料の使いやすいツールです。

Google Business Profile API には、Google で掲載するビジネス情報を管理するためのインターフェースが用意されています。ビジネスは、OAuth の同意を通じて、別のビジネスにアクセス権を付与して、そのビジネスに代わってプロフィールを管理させることができます。

ビジネス プロフィールで管理されているビジネスは、ビジネス プロフィールのオーナー確認プロセスですでに確認されています。ビジネス プロフィールの OAuth 同意フローを拡張して、これらのビジネスをビジネス メッセージにオンボーディングし、ビジネス メッセージでのリリースに向けて自動的に確認できます。

これは、ビジネス メッセージをよりスケーラブルかつ迅速に開始できる方法であり、ビジネス プロフィールの店舗でメッセージ機能を有効にするための推奨フローです。

前提条件

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. 前の手順で取得した OAuth 認証情報によって所有されている Google ビジネス プロフィールのリスティングの名前と一致する displayName を使用して、エージェントを作成します。Google ビジネス プロフィール API を使用して場所を検索し、ビジネスの名前を取得します。

    名前の照合の場合:

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

  3. ビジネス プロフィールの各ロケーションについて、同じ placeId を使用してロケーションを作成します。Google Business Profile API から店舗拠点が取得されると、ビジネス プロフィールの店舗拠点の placeId が LocationKey オブジェクト内に含まれます。

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

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

    正しく設定されていれば、検証リクエストの出力からすぐに VERIFICATION_STATE_VERIFIED の verificationState が返されます。verificationState が異なる値を返す場合は、リクエスト時に正しい OAuth トークンを使用していなかったか、エージェントをビジネス プロフィールの所在地と照合できなかった可能性があります。

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

    エージェントの確認と同様に、正しく行った場合、確認リクエストの出力はすぐに VERIFICATION_STATE_VERIFIED の verificationState を返します。verificationState が異なる値を返す場合は、リクエスト時に正しい OAuth トークンを使用していなかったか、ビジネス プロフィールの所在地が、所有権が主張され、オーナー確認済みのビジネスではない可能性があります。

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

  7. 検索とマップで利用できるようにする場所を起動して、特定の場所でのメッセージを有効にします。リリース プロセスが開始されると、リリースされた各地域のメッセージが数時間以内にユーザーに届きます。

これらの手順を完了すると、すべてのコンシューマ メッセージが登録済みのビジネス メッセージ Webhook に投稿されます。Business Messages API を使用して、コンシューマに返信する必要があります。