一、指令概述
该指令用于调用钉钉开放平台接口,获取钉盘内图片类文件的缩略图在线访问链接,可用于图片预览、消息卡片展示、报表嵌入等场景,需配合「上传文件到钉钉文件存储」指令使用。
可查看文档: https://open.dingtalk.com/document/development/get-file-thumbnails-in-bulk?debug=true
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
| 凭证 | 钉钉开放平台接口调用凭证(access_token) | 必填;通过「获取开发平台凭证」指令获取 |
| 用户 Id | 操作人钉钉用户 ID | 必填;通过「查询用户 Id」指令获取 |
| space_id | 钉盘空间 ID | 必填;通过「获取空间列表」指令获取 |
| 文件 Id | 钉盘内目标文件唯一 ID | 必填;由「上传文件到钉钉文件存储」指令执行后返回 |
| 生成变量【缩略图链接】 | 输出结果变量 | 必填;返回可直接访问的图片缩略图 URL 链接 |
三、典型操作示例
· 凭证:ding_access_token_xxxx
· 用户 Id:m4PgPMMZNiijuStvkgQxxx
· space_id:2882124xxx
· 文件 Id:2206xxxx
· 输出变量:thumbnail_url
· 执行效果:返回图片在线缩略图链接,可直接在浏览器打开预览。
输出结果:

四、注意事项
1. 文件类型限制:仅支持图片格式(jpg、png、gif 等),文档 / 表格等非图片文件无法获取缩略图;