您可以使用 Directory API 的 groups.list 方法搜索与特定属性匹配的群组。此方法接受 query 参数，该参数是一个搜索查询，用于组合一个或多个搜索子句。每个搜索子句由三个部分组成：
- 字段
- 要搜索的组属性。例如
name。 - 运算符
- 对数据执行的测试，以提供匹配项。例如，
=运算符用于测试文本属性是否与某个值匹配。 - 值
- 要测试的属性的内容。例如
groupName。
多个子句之间用空格分隔，并由 AND 运算符隐式连接。
字段
| 字段 | 值类型 | 运算符 | 说明 |
|---|---|---|---|
email |
字符串 | =、:{PREFIX}* |
群组的电子邮件地址。注意：此参数不能在同一查询中与 memberKey 参数搭配使用。 |
name |
字符串 | =、:{PREFIX}* |
群组的显示名称。注意：此参数不能与同一查询中的 memberKey 参数搭配使用。 |
memberKey |
字符串 | =、 |
memberKey 查询参数会返回用户或群组所属的所有群组。此值可以是用户的主电子邮件地址或别名电子邮件地址、群组的主电子邮件地址或别名电子邮件地址，也可以是用户的唯一 ID。注意：此参数不能在同一查询中与 email 或 name 参数一起使用。 |
值类型
| 值类型 | 备注 |
|---|---|
| 字符串 | 如果查询包含空格，请用英文单引号 ' 将其括起来。使用 \' 转义查询中的英文单引号，例如 'Valentine\'s Day'。 |
运算符
| 运算符 | 支持的值类型 | 备注 |
|---|---|---|
= |
字符串、布尔值、数字、日期 | 字段和值完全匹配。例如，name=contact 会与具有 name 属性 "contact" 的所有组匹配，但不会与 "contactgroup" 匹配。大多数字符串字段都支持该类型（见上文）。 |
:{PREFIX}* |
字符串 | 字段以该值开头。例如，包含 email:support* 的查询会与 email 值为 "supportgroup@" 和 "support@" 的组匹配，但不会与 "contactsupport" 匹配。仅适用于一小部分字符串字段（见上文）。 |
示例
所有查询均使用 groups.list 方法，该方法的 HTTP 请求类似于以下内容（添加了换行符以提高可读性）：
GET https://admin.googleapis.com/admin/directory/v1/groups ?domain=primary domain &query=query parameters
query 参数必须进行网址编码。例如，查询 query=email:support* 的网址编码为 query=email%3Asupport*。本页面上的所有示例均显示未编码的 query 参数。客户端库会自动处理此网址编码。
按显示名称搜索群组
name='contact'
搜索与电子邮件前缀匹配的群组
email:admin*
搜索用户的所有群组
memberKey=user@company.com
搜索名称和电子邮件地址以 contact 开头的群组
name:contact* email:contact*