--- > [!NOTE] 目次 ```table-of-contents title: minLevel: 0 maxLevel: 0 includeLinks: true ``` --- > [!NOTE] リスト掲載用文字列 - [Google Drive](https://marketplace.dify.ai/plugin/langgenius/google_drive?source=http%253A%252F%252Flocalhost&language=ja-JP&theme=system)【@dify_ai】(2026年03月08日) --- > [!NOTE] この記事の要約(箇条書き) - Google ドライブ データソース プラグインは、Google ドライブ内のファイルやフォルダへのアクセスを自動化する。 - 主な機能として、ファイル/フォルダの閲覧、ダウンロード、Google Workspace ファイル(Docs、Sheetsなど)の互換形式への自動エクスポート、OAuth 2.0認証をサポートする。 - 設定には、Google Cloud プロジェクト作成、Google Drive API 有効化、OAuth 2.0 認証情報(クライアントID、シークレット)生成、Difyでのプラグイン設定が必要。 - 利用時にドライブコンテンツを閲覧し、ファイルをダウンロード可能。WorkspaceファイルはPDFやXLSXなどに自動変換される。 - 認証失敗、ファイル未検出、リストエラー、OAuth問題など、一般的なトラブルシューティングと解決策が提供されている。 - Google Drive APIには利用制限があり、セキュリティはOAuth 2.0、安全なトークン保管、読み取り専用権限、HTTPS通信で確保される。 - サポートは`[email protected]`を通じて提供され、最終更新日は2025年9月である。 > [!NOTE] 要約おわり --- [マーケットプレイス](https://marketplace.dify.ai/) ![アプリアイコン](https://marketplace.dify.ai/api/v1/plugins/langgenius/google_drive/icon) Googleドライブ 0.1.7 Google ドライブ データソース 長寿 / google\_drive 詳細.インストール [インストール](http://localhost/plugins?package-ids=%5B%22langgenius%2Fgoogle_drive%3A0.1.7%404b7beed604daa0346faf49df4b364705aa84105f134df8f364bbde8468e290ff%22%5D) ## Google ドライブ データソース プラグイン **作者**: langgenius **バージョン**: 0.1.5 **タイプ**: データソース ## 導入 このプラグインはGoogleドライブと連携し、Googleドライブに保存されているファイルやフォルダへの自動アクセスを可能にします。ファイルの閲覧、フォルダの移動、Difyなどのプラットフォームで使用するためのファイルの直接ダウンロードをサポートします。また、Google Workspaceファイル(ドキュメント、スプレッドシート、スライド)を互換性のある形式にエクスポートすることも可能です。 ## 特徴 - **ファイルとフォルダの参照**: Google ドライブのディレクトリ構造をナビゲートします - **ファイルをダウンロード**: Google ドライブからファイルを取得して処理します - **Google Workspace サポート**: Google ドキュメント、スプレッドシート、スライドを互換性のある形式に自動エクスポート - **フォルダナビゲーション** :階層的なフォルダ構造の閲覧をサポート - **ページネーションのサポート**: ページネーションを使用して多数のファイルを効率的に処理します - **OAuth 2.0 認証**: Google の OAuth 2.0 フローを使用した安全な認証 ## 設定 ### 前提条件 このプラグインを使用する前に、次のものが必要です。 1. Googleドライブが有効になっているGoogleアカウント 2. OAuth 2.0 認証情報を作成するための Google Cloud Console へのアクセス 3. Google ドライブ内のアクセスしたいファイル ### 設定手順 1. **Google Cloud プロジェクトを作成します** 。 - [Google Cloud Console](https://console.cloud.google.com/) に移動 - 「プロジェクトを作成」をクリックするか、既存のプロジェクトを選択してください - プロジェクトに名前を付けます(例:「Dify Google Drive Plugin」) 2. **Google Drive API を有効にする**: - Google Cloud プロジェクトで、「API とサービス」→「ライブラリ」に移動します。 - 「Google Drive API」を検索 - それをクリックして「有効にする」を押します 3. **OAuth 2.0 認証情報を作成する**: - 「APIとサービス」→「認証情報」に移動します - 「認証情報を作成」→「OAuthクライアントID」をクリックします。 - プロンプトが表示されたら、まず OAuth 同意画面を構成します。 - **ユーザータイプ**: ニーズに応じて選択します (組織での使用の場合は内部、一般使用の場合は外部) - **アプリ名** :Dify Google Drive Plugin - **ユーザーサポートメール**: あなたのメールアドレス - **開発者連絡先情報**: メールアドレス - OAuth クライアント ID の場合: - **アプリケーションの種類**: Webアプリケーション - **名前**: Dify Google Drive プラグイン - **承認されたリダイレクトURI**: - SaaS (cloud.dify.ai) ユーザーの場合:`https://cloud.dify.ai/console/api/oauth/plugin/langgenius/google_drive/google_drive/datasource/callback` - セルフホストユーザーの場合:`http://<YOUR CONSOLE_API_URL>/console/api/oauth/plugin/langgenius/google_drive/google_drive/datasource/callback` - `<YOUR CONSOLE_API_URL>` 実際のコンソールAPI URLに 置き換えます 4. **OAuth同意画面を構成する**: - 次の OAuth スコープを追加します。 - `https://www.googleapis.com/auth/drive.readonly` \- すべてのファイルを表示およびダウンロード - `https://www.googleapis.com/auth/drive.metadata.readonly` \- ファイルのメタデータを表示する - アプリがテストモードの場合はテストユーザーを追加します 5. **資格情報を取得する**: - OAuth クライアントを作成したら、以下をコピーします。 - **クライアントID** - **クライアントシークレット** - これらはDifyで必要となるので、安全に保管してください。 6. **Difyでプラグインを設定します**: - Difyのデータソースプラグインセクションに移動します - Googleドライブを選択 - **クライアントID** と **クライアントシークレット** を入力してください - 「保存して承認」をクリックします - GoogleのOAuth同意ページにリダイレクトされます - 必要な権限を付与する - 認証が成功するとDifyにリダイレクトされます ## 使用法 ### ファイルの閲覧 プラグインは、Google ドライブのコンテンツを閲覧するためのインターフェースを提供します。 1. **ルートディレクトリ**: Googleドライブのルートから参照を開始します 2. **フォルダナビゲーション**: フォルダをクリックしてその内容を参照します 3. **ファイル情報**: ファイル名、サイズ、種類を表示します 4. **ページネーション**: 多数のファイルがある場合にページ間を移動します ### ファイルのダウンロード ファイルをダウンロードするには: 1. 目的のファイルを参照します 2. ダウンロードするファイルを選択 3. プラグインはファイルの内容とメタデータを取得します ### Google Workspace ファイル プラグインは Google Workspace ファイルを自動的に処理します。 - **Google ドキュメント**: PDF としてエクスポート - **Google スプレッドシート**: Excel (XLSX) としてエクスポート - **Google スライド**: PDF としてエクスポート - **Google 描画**: PNG としてエクスポート - **Google フォーム**: PDF としてエクスポート ## サポートされている操作 | 手術 | 説明 | | --- | --- | | ファイルの一覧 | Google ドライブ内のファイルとフォルダを閲覧する | | フォルダを移動する | 特定のフォルダ内のファイルにアクセスする | | ファイルをダウンロード | Googleドライブからファイルコンテンツを取得する | | ワークスペースファイルのエクスポート | Google Workspace ファイルの自動変換 | | ページネーション | ページトークンを使用して大きなファイルリストを処理する | ## トラブルシューティング ### よくある問題 1. **「認証に失敗しました(401 不正)」エラー**: - アクセストークンの有効期限が切れました - 解決策: Dify設定で接続を再認証する 2. **「ファイルが見つかりません」エラー**: - ファイルが削除または移動された可能性があります - ファイルにアクセスする権限がない可能性があります - 解決策: ファイルが存在し、アクセスできることを確認してください 3. **「ファイルのリストに失敗しました」エラー**: - インターネット接続を確認してください - API 割り当てが超過していないことを確認する - プロジェクトで Google Drive API が有効になっていることを確認します 4. **OAuth 認証の問題**: - リダイレクト URI が完全に一致することを確認します (プロトコルと末尾のスラッシュを含む) - 必要なスコープがすべて設定されていることを確認する - クライアントIDとシークレットが正しいことを確認する 5. **ファイルが表示されない**: - ファイルがゴミ箱に入っているかどうかを確認します(ゴミ箱に入っているファイルは表示されません) - ファイルを表示する権限があることを確認してください - サブフォルダを参照するときに親フォルダのIDが正しいことを確認する ## API の割り当てと制限 Google Drive API には使用量制限があります。 - **1日あたりのクエリ数** :1,000,000,000 - **ユーザーあたり100秒あたりのクエリ数**: 1,000 - **100秒あたりのクエリ数** :10,000 割り当てエラーが発生した場合は、再試行する前に待つか、Google Cloud Console で割り当ての増加をリクエストしてください。 ## セキュリティに関する考慮事項 - **OAuth 2.0**: 認証には安全なOAuth 2.0フローを使用します - **トークンの保管**: アクセストークンとリフレッシュトークンは安全に保存されます - **最小限の権限**: ファイルへの読み取り専用アクセスのみを要求します - **HTTPS**: すべてのAPI通信は暗号化されたHTTPS接続を使用します - **トークン更新**: 可能な場合は期限切れのトークンを自動的に更新します ## プライバシー このプラグインを使用する際にデータがどのように処理されるかについては、 プライバシーポリシー を参照してください。 ## サポート 問題や質問がある場合: - お問い合わせ: [[email protected]](https://marketplace.dify.ai/plugin/langgenius/) - リポジトリ: プロジェクトのリポジトリで更新とドキュメントを確認してください - Google ドライブ API ドキュメント: [https://developers.google.com/drive/api/v3/about-sdk](https://developers.google.com/drive/api/v3/about-sdk) ## 追加リソース - [Google ドライブ API リファレンス](https://developers.google.com/drive/api/v3/reference) - [Web サーバー アプリケーション向け OAuth 2.0](https://developers.google.com/identity/protocols/oauth2/web-server) - [Google Cloud コンソール](https://console.cloud.google.com/) 最終更新日: 2025年9月 カテゴリー データソース タグ ラグ バージョン 0.1.7 長寿 · 2026年2月3日 午後1時18分 要件 最大メモリ 256MB