> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneDrive

> 通过已连接的账户访问并管理 OneDrive 中的文件、文件夹、共享和工作簿数据。

# OneDrive

当你的工作流需要在 OneDrive 中查找、读取、移动、复制、共享或更新文件时，请使用此应用。它也适用于 Excel 工作簿编辑和 SharePoint 列表任务。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 OneDrive 账户。 |
| 操作 | 是 | 要执行的 OneDrive 操作（例如 Get Drive Root、Get Item Metadata、Get Item By Path、Search Items）。 |
| 参数 | 是 | 由操作的架构生成的各个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。也提供 **Raw JSON** 选项卡，适合高级用法。 |
| 步骤失败时 | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请使用登录流程在工作区的 **Integrations** 中连接 OneDrive。如果没有可用的活动连接，步骤会显示一个带有指向 **Integrations** 链接的警告，而不是账户选择器。

## 参数表单

当你选择某个操作时，**Arguments** 部分会根据该操作的输入架构渲染一个表单。引用现有记录的字段包含下拉选择器。

如果你更想手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常见操作

| 操作 | 描述 |
| - | - |
| **Get Drive Root** | 检索已登录用户 OneDrive 的根文件夹。 |
| **Get Item Metadata** | 按项目 ID 检索文件或文件夹的元数据。 |
| **Get Item By Path** | 按驱动器相对路径检索文件或文件夹的元数据。 |
| **Search Items** | 按关键字在 OneDrive 中搜索文件和文件夹。 |
| **List Folder Children** | 列出文件夹中直接包含的文件和文件夹。 |
| **Move Item** | 将文件或文件夹移动到新的父文件夹。 |
| **Copy Item** | 将文件或文件夹复制到新位置。 |
| **Update Item Metadata** | 更新文件或文件夹的元数据。 |
| **Update File Content** | 替换现有文件的内容。 |
| **Download File** | 按项目 ID 下载文件。 |
| **Restore Deleted Item** | 从回收站恢复已删除的文件或文件夹。 |
| **List Drives** | 列出已连接账户或特定用户、组或站点可用的驱动器。 |
| **Get Site Details** | 按 ID 检索 SharePoint 站点的元数据。 |
| **List Site Lists** | 列出 SharePoint 站点上所有可用的列表。 |

具有破坏性的操作，例如删除记录，不会在工作流操作选择器中提供。

## 输出

此步骤会将 OneDrive 响应存储为步骤输出。响应的结构取决于该操作。

在后续步骤中使用完整输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做过，就连接 OneDrive。
2. 向你的工作流添加一个 **OneDrive** 步骤。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get Drive Root**。
5. 填写所需字段。使用 **Insert Variable** 通过前一步的输出引用任意字段值。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效载荷。

## 使用场景

### 分享文件链接

1. Search Items
2. Get Item Metadata
3. Create Sharing Link

### 更新工作簿

1. Create Workbook Session
2. List Worksheets
3. Read Workbook Range
4. Write Workbook Cell

### 跟踪 SharePoint 数据

1. Get Site Details
2. List Site Lists
3. Get List Items
4. Update List Item Fields

## 备注

* 此步骤依赖于你工作区中已连接的 OneDrive 集成。
* 工作流操作选择器会显示一组选定的操作。拥有 OneDrive 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 OneDrive 作为代理工具使用

你也可以在 **Agent Editor** 中将 OneDrive 添加为工具。打开代理，点击 **Add tool**，然后选择 **OneDrive**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 OneDrive 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)，[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md)，以及 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.