如何在Google Apps Script中获取自定义Schema值？GSuite返回undefined

我来帮你搞定这个问题！之前我也碰到过类似的情况，获取自定义Schema返回undefined通常是几个常见原因导致的，咱们一步步排查解决：

1. 先确认API权限与启用状态 #

• 首先得确保你的Google Cloud项目已经启用了Admin SDK Directory API，而且脚本的OAuth权限范围足够。你可以在Apps Script编辑器里，通过「项目设置」→「显示"appsscript.json"清单文件」，检查oauthScopes数组里是否包含了https://www.googleapis.com/auth/admin.directory.user.readonly（只读需求）或者https://www.googleapis.com/auth/admin.directory.user（读写需求）。

2. 检查API调用的参数是否正确 #

这是最容易踩的坑！默认的用户数据投影不会返回自定义Schema，必须显式指定projection: "full"，同时如果你的Schema是仅管理员可见的，还要加上viewType: "admin_view"。

举个实际的代码例子，假设你的自定义Schema名叫employeeDetails：

function fetchCustomSchemaData() {
  const targetUserEmail = "john.doe@yourdomain.com"; // 替换成目标用户的邮箱
  try {
    const userRecord = AdminDirectory.Users.get(targetUserEmail, {
      projection: "full", // 关键参数：必须选full才能拿到自定义Schema
      viewType: "admin_view" // 若Schema是管理员专属，必须加这个
    });

    // 访问自定义Schema的具体字段
    const customData = userRecord.customSchemas.employeeDetails;
    console.log("自定义Schema数据：", customData);
  } catch (err) {
    console.error("获取数据出错：", err.message);
  }
}

3. 验证自定义Schema的名称是否正确 #

有时候可能是拼写错误或者名称记错了，你可以先调用下面的代码列出所有已创建的自定义Schema，确认名称完全一致：

function listAllCustomSchemas() {
  const yourDomain = "yourdomain.com"; // 替换成你的域名
  const schemasList = AdminDirectory.Schemas.list(yourDomain);
  console.log("所有自定义Schema：", schemasList.schemas);
}

4. 确认目标用户已存在该Schema的数据 #

如果用户还没被分配这个自定义Schema的任何字段值，那customSchemas里对应的Schema键就会是undefined。这种情况下，你需要先给用户添加或更新Schema数据，再尝试获取。

5. 调试小技巧 #

如果还是有问题，建议把完整的用户记录打印出来，看看返回的结构里到底有没有customSchemas字段：

console.log(JSON.stringify(userRecord, null, 2));

这样能直观看到API返回的所有数据，帮你定位是API没返回Schema，还是你访问的路径有误。

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