搜索共享云端硬盘

如需搜索特定的一组共享云端硬盘,请将查询字符串 q 字段 与 drives.list 结合使用,通过组合一个或多个搜索字词来过滤要返回的云端硬盘。

查询字符串包含以下三个部分:

query_term operator values

其中:

  • query_term 是要搜索的查询字词或字段。

  • operator 指定查询字词的条件。

  • values 是您要用于过滤搜索结果的特定值。

如需查看可用于过滤共享云端硬盘的查询字词和运算符, 请参阅搜索查询字词和运算符

例如,以下查询字符串会过滤搜索结果,使其仅返回名称为“Google Drive API resources”的共享云端硬盘。

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
标题中包含“confidential”一词且包含 20 个或更多成员的共享云端硬盘 name contains 'confidential' and memberCount >= 20 true
在组织的所有共享云端硬盘中,标题中包含“confidential”一词的共享云端硬盘 name contains 'confidential' and orgUnitId = 'C03az79cb' true
在用户所属的所有共享云端硬盘中,标题中包含“confidential”一词的共享云端硬盘 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 会从左到右评估 andor 运算符,因此,如果不使用括号,则相同的搜索会返回:

  • 仅返回在 2019 年 1 月 1 日之后创建的组织者人数超过 5 人的共享云端硬盘。
  • 返回所有成员人数超过 20 人的共享云端硬盘,即使这些共享云端硬盘是在 2019 年 1 月 1 日之前创建的。