---
title: Dropbox
description: Dropboxでファイルのアップロード、ダウンロード、共有、管理を行う
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="dropbox"
  color="#0061FF"
/>

{/* MANUAL-CONTENT-START:intro */}
[Dropbox](https://dropbox.com/)は、個人やチームがどこからでも安全にファイルを保存、アクセス、共有できる人気のクラウドストレージおよびコラボレーションプラットフォームです。Dropboxは、一人で作業する場合でもグループで作業する場合でも、簡単なファイル管理、同期、強力なコラボレーションのために設計されています。

SimでDropboxを使用すると、次のことができます：

- **ファイルのアップロードとダウンロード**：あらゆるファイルをDropboxにシームレスにアップロードしたり、必要に応じてコンテンツを取得したりできます
- **フォルダの内容を一覧表示**：任意のDropboxディレクトリ内のファイルとフォルダを閲覧できます
- **新しいフォルダの作成**：プログラムでDropbox内に新しいフォルダを作成してファイルを整理できます
- **ファイルとフォルダの検索**：名前やコンテンツでドキュメント、画像、その他のアイテムを検索できます
- **共有リンクの生成**：ファイルやフォルダの公開または非公開の共有リンクを素早く作成できます
- **ファイルの管理**：自動化されたワークフローの一部としてファイルやフォルダの移動、削除、名前の変更ができます

これらの機能により、Simエージェントは重要なファイルのバックアップからコンテンツの配布、整理されたフォルダの維持まで、ワークフロー内で直接Dropbox操作を自動化できます。Dropboxをファイルのソースと保存先の両方として使用することで、ビジネスプロセスの一部としてシームレスなクラウドストレージ管理が可能になります。
{/* MANUAL-CONTENT-END */}

## 使用方法

ファイル管理、共有、コラボレーションのためにDropboxをワークフローに統合します。ファイルのアップロード、コンテンツのダウンロード、フォルダの作成、共有リンクの管理などが可能です。

## ツール

### `dropbox_upload`

Dropboxにファイルをアップロードする

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | ファイルを保存するDropbox内のパス（例：/folder/document.pdf） |
| `fileContent` | string | はい | アップロードするファイルのbase64エンコードされたコンテンツ |
| `fileName` | string | いいえ | オプションのファイル名（パスがフォルダの場合に使用） |
| `mode` | string | いいえ | 書き込みモード：add（デフォルト）またはoverwrite |
| `autorename` | boolean | いいえ | trueの場合、競合がある場合にファイル名を変更します |
| `mute` | boolean | いいえ | trueの場合、このアップロードについてユーザーに通知しません |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `file` | object | アップロードされたファイルのメタデータ |

### `dropbox_download`

Dropboxからファイルをダウンロードして一時リンクを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | ダウンロードするファイルのパス（例：/folder/document.pdf） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `file` | object | ファイルのメタデータ |

### `dropbox_list_folder`

Dropbox内のフォルダの内容を一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | 一覧表示するフォルダのパス（ルートの場合は""を使用） |
| `recursive` | boolean | いいえ | trueの場合、内容を再帰的に一覧表示 |
| `includeDeleted` | boolean | いいえ | trueの場合、削除されたファイル/フォルダを含める |
| `includeMediaInfo` | boolean | いいえ | trueの場合、写真/動画のメディア情報を含める |
| `limit` | number | いいえ | 返す結果の最大数（デフォルト：500） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `entries` | array | ディレクトリ内のファイルとフォルダのリスト |

### `dropbox_create_folder`

Dropboxに新しいフォルダを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | フォルダを作成する場所のパス（例：/new-folder） |
| `autorename` | boolean | いいえ | trueの場合、競合があればフォルダの名前を変更する |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `folder` | object | 作成されたフォルダのメタデータ |

### `dropbox_delete`

Dropbox内のファイルまたはフォルダを削除する（ゴミ箱に移動）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | 削除するファイルまたはフォルダのパス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `metadata` | object | 削除されたアイテムのメタデータ |

### `dropbox_copy`

Dropbox内のファイルまたはフォルダをコピーする

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | はい | コピーするファイルまたはフォルダのソースパス |
| `toPath` | string | はい | コピーされたファイルまたはフォルダの宛先パス |
| `autorename` | boolean | いいえ | trueの場合、宛先で競合があればファイル名を変更する |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `metadata` | object | コピーされたアイテムのメタデータ |

### `dropbox_move`

Dropbox内のファイルまたはフォルダを移動または名前変更する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | はい | 移動するファイルまたはフォルダのソースパス |
| `toPath` | string | はい | 移動されたファイルまたはフォルダの宛先パス |
| `autorename` | boolean | いいえ | trueの場合、宛先で競合があればファイル名を変更する |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `metadata` | object | 移動したアイテムのメタデータ |

### `dropbox_get_metadata`

Dropbox内のファイルまたはフォルダのメタデータを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | メタデータを取得するファイルまたはフォルダのパス |
| `includeMediaInfo` | boolean | いいえ | trueの場合、写真/動画のメディア情報を含める |
| `includeDeleted` | boolean | いいえ | trueの場合、結果に削除されたファイルを含める |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `metadata` | object | ファイルまたはフォルダのメタデータ |

### `dropbox_create_shared_link`

Dropbox内のファイルまたはフォルダの共有可能なリンクを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `path` | string | はい | 共有するファイルまたはフォルダのパス |
| `requestedVisibility` | string | いいえ | 可視性：public、team_only、またはpassword |
| `linkPassword` | string | いいえ | 共有リンクのパスワード（可視性がpasswordの場合のみ） |
| `expires` | string | いいえ | ISO 8601形式の有効期限（例：2025-12-31T23:59:59Z） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `sharedLink` | object | 作成された共有リンク |

### `dropbox_search`

Dropbox内のファイルとフォルダを検索

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `query` | string | はい | 検索クエリ |
| `path` | string | いいえ | 特定のフォルダパスに検索を制限 |
| `fileExtensions` | string | いいえ | フィルタリングするファイル拡張子のカンマ区切りリスト（例：pdf,xlsx） |
| `maxResults` | number | いいえ | 返す結果の最大数（デフォルト：100） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `matches` | array | 検索結果 |
