工具 API

manage.search_file

根据关键字搜索腾讯文档列表,默认按文档标题匹配,可通过 search_type 改为按所有者昵称或正文匹配;支持按文档类型、所有者、文件夹、快捷方式、列表范围、协作空间、时间范围过滤,支持排序和分页(from/size,翻页使用响应中的 next)。单次最多返回 50 条,默认 20 条。仅传关键字(不带任何过滤、排序、翻页条件)时,若传统搜索结果不足 size,会用去重后的 AI 搜索结果补足到 size;传统结果已达到或超过 size,或带任一条件时,不追加 AI 搜索结果

productivityOAuth1 积分

调用信息

工具标识
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 表示不限制终点