Gemini Enterprise の Google ドライブ データストアを使用すると、ファイルやフォルダなどの Google ドライブデータを検索して操作できます。
サポートされているアクション
Google ドライブ データストアが有効になっている場合、エンドユーザーは Gemini Enterprise で自然言語のコマンドを使用して次の操作を行うことができます。
次のアクションは Google ドライブのデータを読み取るもので、デフォルトで有効になっています。
| アクション | 説明 |
|---|---|
| ファイルの内容をダウンロードする | Google ドライブ ファイルのコンテンツをダウンロードします。 |
| セルの値を取得する | Google スプレッドシートからセルの値を読み取ります。 |
| ファイルのメタデータを取得する | Google ドライブのファイルのメタデータを取得します。 |
| ファイルへのアクセス許可を取得する | Google ドライブ ファイルの権限を一覧表示します。 |
| スプレッドシートを取得する | Google スプレッドシートのコンテンツとメタデータを読み取ります。 |
| 最近使用したファイルを一覧表示する | Google ドライブで最近使用したファイルを一覧表示します。 |
| 共有ドライブを一覧表示する | Google ドライブの共有ドライブを一覧表示します。 |
| ドキュメントの読み取り | Google ドキュメントのドキュメントの内容を読み取ります。 |
| ファイルの内容を読み取る | Google ドライブ ファイルの内容を読み取ります。 |
| プレゼンテーションを読み取る | Google スライドのプレゼンテーションの内容を読み取ります。 |
| ファイルの検索 | クエリに一致する Google ドライブ ファイルを検索します。 |
次のアクションは Google ドライブのデータを変更します。管理者が有効にするまで、デフォルトで無効になっています。
| アクション | 説明 |
|---|---|
| ファイルをコピーする | Google ドライブのファイルをコピーします。 |
| ファイルを作成 | Google ドライブに新しいファイルを作成します。 |
| 項目を挿入する | Google スプレッドシートのワークシートに行または列を挿入します。 |
| ファイルを共有 | Google ドライブのファイルを 1 人以上のユーザーと共有します。 |
| ファイルをゴミ箱に移動 | Google ドライブのファイルをゴミ箱に移動します。 |
| セルの値を更新する | セルの値を Google スプレッドシートに書き込みます。 |
| ファイルを更新 | 既存の Google ドライブ ファイルを更新します。 |
| 数式を更新する | Google スプレッドシートのスプレッドシートに数式を書き込みます。 |
アクションは、コネクタを承認したユーザーの権限で実行されます。ユーザーは、Google ドライブですでに読み取りと変更が可能なデータのみを読み取り、変更できます。
必要なスコープ
Googleが管理する OAuth アプリは、次の OAuth スコープをリクエストします。ユーザーは、コネクタを承認するときに次のスコープを付与します。
| 範囲 | 目的 |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
Google ドライブのコンテンツを検索して取得します。データストアがファイルとフォルダの一覧表示、メタデータの表示、権限の一覧表示、ファイル コンテンツの読み取りを行えるようにします。 |
https://www.googleapis.com/auth/drive.metadata.readonly |
Google ドライブ ファイルのメタデータを読み取る。 |
https://www.googleapis.com/auth/drive.file |
ユーザーがコネクタを使用して開くか作成するファイルを作成、更新する。 |
https://www.googleapis.com/auth/drive.appdata |
アプリケーション固有のデータを Google ドライブに保存する。 |
https://www.googleapis.com/auth/drive |
Google ドライブのファイルに対して書き込み操作(コピー、共有、ゴミ箱への移動、更新など)を実行する。 |
制限事項
- Google ドライブ データストアは、
global、us、euのロケーションでのみサポートされています。
セキュリティ管理を使用する場合は、次の表で説明するように、Google ドライブのデータに関連する制限事項に注意してください。
セキュリティ対策 次の点にご注意ください データ所在地(DRZ) Gemini Enterprise では、 Google Cloudでのデータ所在地のみが保証されます。データ所在地と Google ドライブについては、Google Workspace のコンプライアンス ガイダンスとドキュメント(Google Workspace のデータ リージョンなど)をご覧ください。また、データを保存するリージョンを選択するやデジタル主権などの例もご確認ください。 顧客管理の暗号鍵(CMEK) 鍵は Google Cloud内のデータのみを暗号化します。Cloud Key Management Service の制御は、Google ドライブに保存されているデータには適用されません。 アクセスの透明性 アクセスの透明性では、Google の担当者が Google Cloud プロジェクトに対して行った操作が記録されます。また、Google Workspace によって作成されたアクセスの透明性ログを確認する必要があります。詳しくは、Google Workspace 管理者向けヘルプ ドキュメントのアクセスの透明性ログイベントをご覧ください。
検索に関する一般的な問題
検索しても目的のファイルが見つからない場合や、Gemini Enterprise ウェブアプリで一致する Google ドライブ ファイルが見つからないと報告された場合は、次の問題と解決策を確認してください。
Gemini Enterprise の Google Workspace データへのアクセスが無効になっています
症状: Gemini Enterprise ウェブアプリで、一致する Google ドライブ ファイルが見つからなかったことが報告されるか、Search API を介して送信された検索リクエストで 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin. エラー(または警告)が返されます。Cloud Logging でデータストアのエラーログを調べることもできます。Gemini Enterprise データストアのトラブルシューティングをご覧ください。
問題: ユーザーの Google Workspace 組織の Google 管理コンソールで、[Gemini Enterprise に Google Workspace データへのアクセスを許可する] 設定がオフになっている。
解決策: ユーザーの組織の Google Workspace 管理者に、Gemini Enterprise に Google Workspace データへのアクセスを許可するを有効にするよう依頼します。組織間の設定では、ユーザーが Google ドライブにクエリを実行する各 Google Workspace 組織の管理者が、この設定を有効にする必要があります。
ユーザーとデータストアが異なる Google Workspace 組織に属している
症状: Google Cloud プロジェクトとは異なる Google Workspace 組織からログインしたユーザーに、Gemini Enterprise ウェブアプリで Google ドライブの結果が表示されない。または、Search API を介して送信されたリクエストが 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
... エラーを返す。ログで 403 エラーを確認するには、Cloud Logging で Gemini Enterprise コネクタのエラーログにアクセスするをご覧ください。
問題: デフォルトでは、Gemini Enterprise は、ユーザーの Google Workspace お客様 ID が Google ドライブ データストアと Google Cloud プロジェクトの組織と一致する場合にのみ、ユーザーが Google ドライブ データストアを検索できるようにします。
解決策: 組織間の設定を完了します。
- Cloud カスタマーケアに連絡して、ユーザーが Gemini Enterprise にアクセスする各 Google Workspace 組織のお客様 ID を Google Cloud プロジェクトの許可リストに追加します。
- 各 Google Workspace 組織の Google Workspace 管理者に、[Gemini Enterprise に Google Workspace データへのアクセスを許可する] を有効にしてもらいます。
- ユーザーが自分の組織外で所有されているドキュメントを検索する必要がある場合は、[ウェブアプリの機能を管理する] で [クロスドメインのドキュメントを含める] を有効にします。
1 MB のテキスト抽出上限を超えるキーワードは検索できません。
症状: 大きなファイルの後半に表示されるキーワードを検索しても、ファイルが返されません。
問題: Google ドライブでは、検索できるように、ファイルから 1 MB のテキストと書式設定データのみを抽出します。1 MB のインデックス上限を超えるキーワードは検索できません。
解決策: ファイルの最初の 1 MB に含まれる用語を使用して検索するか、大きなドキュメントを小さなファイルに分割します。
サイズまたは PDF ページ数の上限を超えているファイルはインデックスに登録されません
症状: 特定の大きなファイルや長い PDF が検索結果に表示されない。
問題: Google ドライブのサイズまたはページ数の上限を超えているファイルはインデックスに登録されず、検索結果に表示されません。
- ほとんどのファイル形式では、ファイルサイズの上限は 10 MB です。ただし、次の例外があります。
- XLSX ファイル: 最大 20 MB。
- PDF ファイル: 最大 30 MB。
- テキスト ファイル: 最大 100 MB。
- PDF ファイルの光学式文字認識(OCR)は 80 ページに制限されています。 また、50 MB または 80 ページを超える PDF は Google ドライブのインデックスに登録されません。
解決策: ファイルサイズを小さくするか、これらのインデックス登録の上限を超えるファイルや PDF を分割します。
次のステップ
- Google ドライブでデータストアを作成して構成する。 Google ドライブ データストアを設定するをご覧ください。