GAM（Google Admin）：如何查询自定义字段为空的用户？

针对Google Workspace中布尔型自定义字段为空的用户导出需求，正确的GAM查询方式是利用Directory API的存在性匹配语法，具体如下：

• 基础导出命令：直接导出所有该自定义字段无值的用户列表

  gam print users query "NOT Non-Person_Account.Non-Person_Account:*"
  

• 指定字段导出：如果只需要特定字段（比如邮箱和目标自定义字段），可以添加fields参数过滤输出

  gam print users fields primaryEmail,Non-Person_Account.Non-Person_Account query "NOT Non-Person_Account.Non-Person_Account:*"
  

原理说明 #

Google Workspace Directory API的查询语法中，字段名:*表示匹配存在该字段且有任意值的用户；反之，NOT 字段名:*则匹配**该字段不存在（即无值）**的用户。你之前尝试的null/empty等关键词并不符合Directory API的查询规则，因此会触发报错。

内容的提问来源于stack exchange，提问作者MSt