Gmail データストアを設定する

このページでは、データストアを作成して Gmail を Gemini Enterprise に接続する方法について説明します。

始める前に

  • 接続する Google Workspace インスタンスで使用するアカウントと同じアカウントで Google Cloud コンソールにログインします。Gemini Enterprise は、Google Workspace お客様 ID を使用して Gmail に接続します。個人用の Google アカウント（末尾が @gmail.com の一般ユーザー向けアカウント）には顧客 ID がなく、サポート対象外です。

  • Gemini Enterprise でデータソースのアクセス制御を適用してデータを保護するには、ID プロバイダが構成されていることを確認してください。

  • スマート機能を有効にする: Google Workspace アカウントで、[Google Workspace のスマート機能] と [他のGoogle サービスのスマート機能] の両方をオンにします。詳しくは、Google Workspace のスマート機能をオンまたはオフにするをご覧ください。

  • OAuth アプリを許可リストに登録する（管理者のみ）: Gmail データストアは、 Googleで管理される OAuth アプリを使用してデータにアクセスします。組織で OAuth アプリへのアクセスが制限されている場合は、Google Workspace 管理者がこのアプリを組織の許可リストに追加する必要があります。詳しくは、 Googleで管理されている OAuth アプリを許可リストに登録するをご覧ください。

Gmail データストアを作成する

Gmail データストアを作成するには、次の手順を実行します。

  1. Google Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択するか作成します。

  3. ナビゲーション メニューで [データストア] をクリックします。

  4. [+ データストアを作成] をクリックします。

  5. [ソース] で Gmail を検索し、[選択] をクリックします。

  6. [アクション] セクションで、リストからアクションを選択して、Gmail コネクタに対して有効にします。

    アクションのリストを管理するには、アクションの管理をご覧ください。

  7. [続行] をクリックします。

  8. [構成] セクションで、次の操作を行います。

    1. [マルチリージョン] リストから、データコネクタのロケーションを選択します。
    2. [データコネクタ名] フィールドに、コネクタの名前を入力します。
    3. ロケーションとして us または eu を選択した場合は、暗号化設定を構成します。
      • [Google管理の暗号鍵] または [Cloud KMS 鍵] を選択します。
      • [Cloud KMS 鍵] を選択した場合:
        • [鍵管理のタイプ] リストで、適切なタイプを選択します。
        • [Cloud KMS 鍵] リストで、鍵を選択します。
      詳細については、顧客管理の暗号鍵をご覧ください。

  9. 省略可: [Sensitive Data Protection ポリシー] セクションで、既存の Sensitive Data Protection ポリシーを関連付けて、Gemini Enterprise がこのデータストアから取得したデータを検査して匿名化します。組織で Sensitive Data Protection ポリシーが必要ない場合は、この手順をスキップできます。

  10. データストアの作成フローに [詳細オプション] セクションが表示されている場合は、そのセクション内で [静的 IP アドレスを有効にする] チェックボックスをオンにできます。これにより、データストアはアウトバウンド トラフィックに固定 IP アドレスのセットを使用するため、ソースシステムでの許可リスト登録に適しています。詳細については、静的 IP 下り（外向き）を構成するをご覧ください。

  11. [作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、Gmail コネクタを使用できるようになります。

データストアを作成したら、クエリを実行する前にアプリを作成し、Gmail データストアに接続します。

クエリの実行

このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。

Gmail を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。

  • Gemini Enterprise は、検索クエリを Gmail API に直接送信します。
  • Gemini Enterprise は、結果を他の接続されたデータソースからの結果と統合して、包括的な検索結果を表示します。

エラー メッセージとトラブルシューティング

次の表に、Gmail コネクタの使用時に発生する可能性のある一般的なエラー メッセージを示します。HTTP エラーコードや推奨されるトラブルシューティングの手順も記載されています。

エラーコード エラー メッセージ 説明 トラブルシューティング
403（アクセスの拒否） サービス アカウントの認証情報を使用した検索は、Google Workspace のデータストアではサポートされていません。 検索対象のエンジンに Google Workspace データストアがあり、渡された認証情報はサービス アカウントのものです。Google Workspace データストアでサービス アカウントの認証情報を使用して検索することはできません。 ユーザー認証情報を使用して検索を呼び出すか、Google Workspace データストアをエンジンから削除します。
403（アクセスの拒否） Google Workspace データストアでは一般ユーザー向けアカウントはサポートされていません。 検索は一般ユーザー向けアカウント（@gmail.com）の認証情報を使用して呼び出されますが、これは Google Workspace データストアではサポートされていません。 エンジンから Google Workspace データストアを削除するか、管理対象の Google アカウントを使用します。
403（アクセスの拒否） データストアに対してお客様 ID が一致しません 検索は、Google Workspace データストアと同じ組織に属するユーザーのみに許可されています。 ユーザーと Google Workspace データストアが異なる組織に属している場合は、Google Workspace データストアをエンジンから削除するか、サポートにお問い合わせください。
403（アクセスの拒否） Agent Space による Workspace へのアクセスが、組織管理者によって無効にされています。 Google Workspace 管理者が Gemini Enterprise の Google Workspace データへのアクセスを無効にしています。 アクセスを有効にするには、Google Workspace 管理者にお問い合わせください。

次のステップ