Google カレンダー データストアを設定する

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

始める前に

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

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

  • Google カレンダーのデータストアにアクションを追加する前に、 Google Cloud 管理者が Google カレンダーの認証と権限を設定するの手順を完了し、OAuth 2.0 認証を構成してクライアント ID とクライアント シークレットを提供し、スコープを設定する必要があります。

Google カレンダー データストアを作成する

Google カレンダー データストアを作成する手順は次のとおりです。

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

    Gemini Enterprise

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

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

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

  5. [ソース] で「Google Calendar カレンダー」を検索し、[選択] をクリックします。

  6. [アクション] セクションで次の操作を行います。

    1. OAuth 2.0 アプリケーションから取得したクライアント ID とクライアント シークレットを入力し、[認証を確認する] をクリックします。

      詳細については、OAuth クライアント認証情報を作成するをご覧ください。検索とアクションに必要なスコープについては、必要なスコープをご覧ください。

    2. 省略可: [詳細設定] を開き、 Google Cloud プロジェクトに Service Directory で作成したサービスのリソース名を [サービス名] に入力します。VPC Service Controls が有効な場合、このフィールドは必須です。

    3. リストからアクションを選択して、Google カレンダー コネクタに対して有効にします。

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

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

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

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

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

  10. [お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。

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

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

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

クエリ実行

Google カレンダーを承認した後、検索クエリを入力すると、次のようになります。

  1. Gemini Enterprise は、検索クエリを Google Calendar API に送信します。

  2. Gemini Enterprise は、結果を他のソースからの結果と統合して表示します。

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

次の表に、この Google データソースを扱う際に表示される可能性のあるエラー メッセージを、HTTP エラーコードや推奨のトラブルシューティング手順とともに示します。

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

次のステップ