一、指令概述
本指令用于钉钉云盘（钉盘）检索，通过名称关键词模糊匹配目标文件 / 文件夹，自动分页遍历钉盘目录，批量返回匹配对象的全套唯一标识字段，输出结构化数组，为上传文件、获取文件链接、下载文件、目录管理等钉盘操作提供必填 ID 参数。
可参考链接： https://open.dingtalk.com/document/development/search-for-files?debug=true
二、输入参数明细
| 参数名称 | 控件类型 | 获取来源 & 填写规则 | 参数作用 |
|---|---|---|---|
| 凭证 | 输入框 | 由「获取开发平台凭证」指令获取 access_token | 钉钉开放接口鉴权凭证，必填 |
| Union_id | 输入框 | 由「获取用户详情信息」指令获取用户唯一 UnionID | 检索操作人的身份标识，限定检索权限范围，必填 |
| 关键词 | 输入框 | 填写文件 / 文件夹完整或模糊名称 | 检索匹配关键字，支持模糊查询，匹配名称包含该文本的钉盘对象 |
三、输出参数
| 输出变量名 | 数据类型 | 输出内容说明 |
|---|---|---|
| 文件内容数据 | 对象数组 | 每条元素包含：文件 / 文件夹名称、全局唯一 dentryUuid、spaceId 空间 ID、传统 dentryId 文件 / 文件夹 ID |
四、实操配置示例
场景：检索钉盘「Temu 物流对账」文件夹
- 凭证：
ding_access_token_xxxx - Union_id：
m4PgPMMZNiijuStvkgQD2VAiEiE - 关键词：
Temu物流对账 - 输出变量：
ding_file_list：[ { "name": "Temu物流对账", "dentryUuid": "pYLaezmVNe3XYG3DFPzxxxxxxWrMqPxX6", "spaceId": "28822xxxxx", "文件夹/文件ID": "22xxxxxxxx" } ]
需开通以下俩个权限：
