菜单

删除文件

一、指令概述

该 RPA 指令用于删除飞书云盘指定类型的文件,需配置飞书访问凭证、文件唯一标识(文件Token)及文件类型(如docxfile等),执行后返回删除任务 ID,适用于飞书文件的精准清理场景。

飞书官方开发文档参考:https://open.feishu.cn/document/server-docs/docs/drive-v1/file/delete

二、调用参数配置示意

参数名称示例 / 默认值说明
指令删除文件固定选择 “删除文件”,执行飞书文件删除操作。
飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证(需具备文件删除权限,可通过 “获取飞书访问凭证” 指令生成),支持变量(界面显示 “{x}” 标识)。
文件 TokenOsYid****************输入要删除文件的唯一标识 Token(需为飞书云盘合法文件的有效 Token),关键字符已打码,支持变量。
文件类型docx / file / bitable选择待删除文件的类型(需与文件实际类型匹配,否则接口返回失败),下拉可选:- file:普通文件类型;- docx:新版文档类型;- bitable:多维表格类型;- doc:文档类型;- sheet:电子表格类型等,支持变量。
生成的变量 - 运行结果变量(自定义变量名)存储文件删除操作的执行结果(包含任务 ID),需配置为自定义变量,后续流程可调用,支持变量。

三、使用示例(删除新版文档场景)

场景:删除飞书云盘类型为docx的文件(Token 为OsYid****************)。

参数配置:

指令:删除文件

飞书访问凭证:feishuAuthToken(通过 “获取飞书访问凭证” 指令生成的变量)

文件 Token:OsYid****************(文件唯一标识,关键字符已打码)

文件类型:docx

运行结果:deleteResult(自定义变量,存储删除结果)

执行流程:

调用该 RPA 指令后,RPA 会通过 feishuAuthToken 完成飞书 API 认证,根据打码后的文件 Token 和匹配的文件类型docx,执行文件删除操作;操作完成后,将包含任务 ID 的结果存入 deleteResult 变量,便于后续确认删除状态或记录操作日志。

四、返回结果说明

飞书 API 标准返回示例(成功场景):

指令执行后,“运行结果” 变量(如deleteResult)会存储包含删除任务 ID 的 JSON 结果,格式如下:

{ "code": 0, "msg": "success", "data": { "task_id": "7360595374803812356" }}

响应字段含义:

code:状态码,0 表示删除操作成功,非 0 为失败(具体错误码含义参考飞书官方文档)。

msg:提示信息,success 表示删除成功。

data.task_id:删除任务的唯一标识 ID,可用于追踪删除任务的执行状态(若需确认删除结果,可结合飞书任务查询接口使用)。

五、注意事项

1. 访问凭证权限:“飞书访问凭证” 需具备文件删除权限(如 “Delete file” 权限)且未过期,否则会返回 code=403(权限不足)错误。

2. 文件类型匹配性文件类型需与待删除文件的实际类型完全一致(如文件是新版文档则选docx,普通文件选file),否则接口会返回失败(如code=400 参数不匹配错误)。

3. 文件 Token 准确性文件Token 需为飞书云盘合法文件的有效 Token(打码不影响实际值校验),否则会返回 code=404(文件不存在)错误。

4. 操作不可逆性:文件删除操作一旦执行,飞书云盘中的对应文件将被移除(若需恢复需依赖飞书回收站机制),请确保操作前确认文件无需保留。

六、延伸应用

可结合 RPA 的 “获取文件夹中的文件清单” 指令,实现飞书云盘文件批量精准清理:例如先调用 “获取文件夹中的文件清单” 指令,筛选出类型为docx且满足清理条件的文件 Token 列表,再循环调用本 “删除文件” 指令,自动删除列表中的文件,替代人工手动逐个判断类型并删除的重复工作,提升文件清理效率。


上一个
获取空间元数据
下一个
获取文件夹中的文件清单
最近修改: 1970-01-01