使用Google Apps Script Directory API按前缀检索组时query参数报错

尝试通过以下代码检索邮箱前缀为students的群组时，query参数被拒绝：

var OUPageToken;
var groupList = AdminDirectory.Groups.list({
  customer:"my_customer", 
  domain: "mydomain.com",
  maxResults: 500,
  pageToken: OUPageToken,
  query: "'email=students*'"
})["groups"];

抛出错误：

Error
GoogleJsonResponseException: API call to directory.groups.list failed with error: Invalid Input: query

疑问：Admin SDK的REST版本与Apps Script版本是否存在差异？

错误原因 #

问题出在query参数的格式上：查询语句多了一层不必要的单引号包裹，导致API无法解析查询规则。

修正后的代码 #

var OUPageToken;
var groupList = AdminDirectory.Groups.list({
  customer:"my_customer", 
  domain: "mydomain.com",
  maxResults: 500,
  pageToken: OUPageToken,
  query: "email=students*"
})["groups"];

关于SDK版本差异 #

Admin SDK的REST版本和Apps Script版本在Groups.list的query参数规则上完全一致，两者遵循相同的查询语法，不存在功能差异。你遇到的问题只是参数格式错误，和版本无关。

扩展说明 #

如果需要组合多个查询条件，直接按照语法拼接即可，无需额外引号包裹，例如：

query: "email=students* AND name:Class"

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