如需搜索一组特定的共享云端硬盘,请将查询字符串 q
字段与 drives.list
结合使用,通过组合一个或多个搜索字词来过滤要返回的云端硬盘。
查询字符串包含以下三个部分:
query_term operator values
其中:
query_term
是搜索查询字词或字段。operator
指定查询字词的条件。values
是您要用来过滤搜索结果的具体值。
如需查看可用于过滤共享云端硬盘的查询字词和运算符,请参阅搜索查询字词和运算符。
例如,以下查询字符串会过滤搜索结果,仅返回名称为“Google Drive API 资源”的共享云端硬盘。
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
查询字符串示例
下表列出了一些共享云端硬盘的基本查询字符串示例。实际代码因您用于搜索的客户端库而异。
您还必须转义文件名中的特殊字符,以确保查询正常运行。例如,如果文件名同时包含撇号 ('
) 和反斜线 ("\"
) 字符,请使用反斜线对它们进行转义:name
contains 'quinn\'s paper\\essay'
。
您要查询的内容 | 示例 | useDomainAdminAccess 设置 |
---|---|---|
2017 年 6 月 1 日之后创建的共享云端硬盘 | createdTime > '2017-06-01T12:00:00' |
true |
默认视图中显示的共享云端硬盘 | hidden = false |
false |
有多个成员的共享云端硬盘 | memberCount > 1 |
true |
标题中包含“机密”字样的共享云端硬盘,且成员人数不少于 20 人 | name contains 'confidential' and memberCount >= 20 |
true |
组织的所有共享云端硬盘中,标题中包含“机密”字样的共享云端硬盘 | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
用户是成员的所有共享云端硬盘中标题中包含“机密”一词的共享云端硬盘 | name contains 'confidential' |
false |
未指定组织者的共享云端硬盘 | organizerCount = 0 |
true |
不包含组织部门 ID 的共享云端硬盘 | orgUnitId != 'C03az79cb' |
true |
使用括号查询多个字词
您可以使用括号将多个查询字词组合在一起。例如,如需搜索在特定日期之后创建且组织者或成员超过 5 人或 20 人的共享云端硬盘,请使用以下查询:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
此搜索会返回在 2019 年 1 月 1 日之后创建且组织者或成员超过 5 人或 20 人的所有共享云端硬盘。
Drive API 会从左到右对 and
和 or
运算符进行求值,因此不带括号的相同搜索将返回:
- 仅限创建时间在 2019 年 1 月 1 日之后且组织者人数超过 5 人的共享云端硬盘。
- 成员超过 20 人的所有共享云端硬盘,即使是 2019 年 1 月 1 日之前创建的共享云端硬盘也是如此。