工具 API
manage. search_ file
根据关键字搜索腾讯文档列表,默认按文档标题匹配,可通过 search_type 改为按所有者昵称或正文匹配;支持按文档类型、所有者、文件夹、快捷方式、列表范围、协作空间、时间范围过滤,支持排序和分页(from/size,翻页使用响应中的 next)。单次最多返回 50 条,默认 20 条。仅传关键字(不带任何过滤、排序、翻页条件)时,若传统搜索结果不足 size,会用去重后的 AI 搜索结果补足到 size;传统结果已达到或超过 size,或带任一条件时,不追加 AI 搜索结果
调用信息
- 工具标识
- tencent-docs.manage.search_file
- 服务提供方
- 腾讯文档
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
asc是否升序排列,默认 false 即降序(最新在前)
file_types文档类型过滤,多个类型取并集,不传则不过滤。可选值:doc-在线文档,sheet-在线表格,slide-在线幻灯片,form-收集表,pdf-PDF,smartcanvas-智能文档,smartsheet-智能表格,mind-思维导图,flowchart-流程图,board-白板,ofd-OFD,word-Word 类文件(doc/docx/wps 等),excel-Excel 类文件(xls/xlsx/csv 等),ppt-PPT 类文件(ppt/pptx/dps 等)
from分页起始条目编号,从 0 开始,默认 0;翻页时传入上一次响应返回的 next
list_type限定搜索的列表范围:my_doc-我的文档,recent-最近浏览,collaboration-共享空间,不传则不限定
need_space_folder是否在结果中包含空间文件夹,默认 false
only_folder是否仅搜索文件夹,true-仅返回文件夹,默认 false 不过滤
only_link是否仅搜索快捷方式(链接),true-仅返回快捷方式,默认 false 不过滤
only_space是否仅搜索协作空间内的文档,true-仅搜索协作空间,默认 false 不过滤
owner_filter所有者过滤:self-仅我拥有的文档,others-仅他人拥有的文档,不传则不过滤
range_by时间范围过滤所使用的时间字段:access_time-访问时间,modify_time-修改时间(默认),create_time-创建时间;仅在传入 time_begin 或 time_end 时生效
search_key必填搜索关键字
search_type关键字匹配方式:title-按文档标题匹配(默认),owner_nick-按所有者昵称匹配,content-按正文内容匹配(需 VIP 或专业版)
size单次返回条目数,取值 1~50,不传或传 0 时默认 20
sort_by排序字段:access_time-访问时间,modify_time-修改时间(默认),create_time-创建时间
time_begin时间范围起点,毫秒级 Unix 时间戳,闭区间;不传或传 0 表示不限制起点
time_end时间范围终点,毫秒级 Unix 时间戳,闭区间,须不小于 time_begin;不传或传 0 表示不限制终点