tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

搜索

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 10:49:08

简介

本文档提供关于搜索文件/目录的 API 概览以及 SDK 示例代码。
API
操作描述
用于搜索目录与文件
用于继续获取搜索结果
用于删除搜索任务

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参见 SDK API 参考

搜索目录与文件

功能说明

初始化搜索,可能会返回一定量的搜索结果。

示例代码

QCloudSMHInitiateSearchRequest *req = [QCloudSMHInitiateSearchRequest new];
// 媒体库 ID,必选参数
req.libraryId = @"libraryId"
// 空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数
req.spaceId = @"spaceId";
// 搜索范围,指定搜索的目录,如搜索根目录可指定为空字符串、“/”或不指定该字段
req.scope = scopeDir.totalPath;
// 搜索关键字,可使用空格分隔多个关键字,关键字之间为“或”的关系并优先展示匹配关键字较多的项目;
req.keyword = @"keyWord";
// 搜索类型,字符串或字符串数组 QCloudSMHSearchType
req.searchTypes = @[@(type)];
[req setFinishBlock:^(QCloudSMHSearchListInfo *_Nullable result, NSError *_Nullable error) {

}];
[[QCloudSMHService defaultSMHService] initSearch:req];

继续获取搜索结果

功能说明

继续获取搜索结果。

示例代码

QCloudSMHResumeSearchRequest *req = [QCloudSMHResumeSearchRequest new];
// 媒体库 ID,必选参数
req.libraryId = self.userModel.libraryId;
// 空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数
req.spaceId = scopeDir.teamInfo.spaceId;
// 搜索任务 ID 初始化搜索时返回
req.searchId = searchId;
// 分页标识,创建搜索任务时或继续获取搜索结果时返回的 nextMarker 字段;
req.nextMarker = nextMarker;
[req setFinishBlock:^(QCloudSMHSearchListInfo *_Nullable result, NSError *_Nullable error) {

}];
[[QCloudSMHService defaultSMHService] resumeSearch:req];

删除搜索

功能说明

用于删除搜索任务。

示例代码

QCloudSMHAbortSearchRequest *req = [QCloudSMHAbortSearchRequest new];
// 媒体库 ID,必选参数
req.libraryId = self.userModel.libraryId;
// 空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数
req.spaceId = scopeDir.teamInfo.spaceId;
// 搜索任务 ID
req.searchId = @"searchId";
[req setFinishBlock:^(QCloudSMHSearchListInfo *_Nullable result, NSError *_Nullable error) {
if (error) {
[liveData postError:error];
return;
} else {
[liveData postValueAndComplete:searchId];
}
}];
[[QCloudSMHService defaultSMHService] abortSearch:req];


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈