如何用GAS批量为Gmail用户添加发送别名并设为默认？

我看到你已经有了单个用户的测试代码，现在需要扩展到批量处理所有域用户，下面是完整的实现方案，包含服务账号认证、域用户获取、别名添加及默认设置的全流程：

前期准备工作 #

在开始写代码前，得先确保这些配置都到位：

• 你的Google Cloud项目已经启用了Gmail API和Admin SDK Directory API
• 给服务账号配置了域范围委托（Domain-Wide Delegation），必须添加这几个OAuth权限范围：
  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing
  • https://www.googleapis.com/auth/admin.directory.user.readonly（用来批量拉取域用户）
• 域管理员已经授权服务账号使用上述权限

完整代码实现 #

把你的服务账号配置替换进去，修改别名信息后就能直接运行：

// 替换成你的服务账号配置
const SERVICE_ACCOUNT_CONFIG = {
  private_key: "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY_HERE\n-----END PRIVATE KEY-----\n",
  client_email: "your-service-account@project-id.iam.gserviceaccount.com",
  client_id: "YOUR_CLIENT_ID"
};

// 替换成你要添加的别名信息
const TARGET_ALIAS = {
  email: "alias@yourdomain.com",
  displayName: "默认发件别名"
};

function batchSetupDefaultAlias() {
  // 1. 获取域内所有用户（可根据需求过滤，比如指定OU）
  const domainUsers = fetchDomainUsers();
  
  // 2. 逐个处理用户
  domainUsers.forEach(user => {
    const userEmail = user.primaryEmail;
    console.log(`开始处理用户: ${userEmail}`);
    
    try {
      // 初始化模拟用户身份的Gmail服务
      const gmailService = getAuthorizedGmailService(userEmail);
      
      // 检查别名是否已存在，避免重复操作
      const existingAliases = getUserAliases(gmailService);
      const aliasExists = existingAliases.some(alias => alias.sendAsEmail === TARGET_ALIAS.email);
      
      if (!aliasExists) {
        addUserAlias(gmailService);
        console.log(`已为${userEmail}添加别名: ${TARGET_ALIAS.email}`);
      } else {
        console.log(`${userEmail}已存在目标别名，跳过添加步骤`);
      }
      
      // 设置该别名为默认发件账户
      setAliasAsDefault(gmailService);
      console.log(`已将${TARGET_ALIAS.email}设为${userEmail}的默认发件账户`);
      
    } catch (err) {
      console.error(`处理用户${userEmail}失败: ${err.message}`);
    }
  });
  
  console.log("批量处理任务完成！");
}

// 获取域内用户列表（使用Admin SDK）
function fetchDomainUsers() {
  const adminService = getAuthorizedAdminService();
  const response = adminService.users.list({
    customer: "my_customer", // 代表当前域
    maxResults: 500, // 单次最多拉500个，可按需调整
    orderBy: "email"
  });
  
  return response.users || [];
}

// 初始化Admin SDK服务（需要模拟管理员身份）
function getAuthorizedAdminService() {
  const jwt = new google.auth.JWT(
    SERVICE_ACCOUNT_CONFIG.client_email,
    null,
    SERVICE_ACCOUNT_CONFIG.private_key,
    ["https://www.googleapis.com/auth/admin.directory.user.readonly"],
    "admin@yourdomain.com" // 替换成域内有用户读取权限的管理员邮箱
  );
  
  jwt.authorize();
  
  return google.admin({
    version: "directory_v1",
    auth: jwt
  });
}

// 初始化Gmail服务（模拟目标用户身份）
function getAuthorizedGmailService(userEmail) {
  const jwt = new google.auth.JWT(
    SERVICE_ACCOUNT_CONFIG.client_email,
    null,
    SERVICE_ACCOUNT_CONFIG.private_key,
    ["https://www.googleapis.com/auth/gmail.settings.basic", "https://www.googleapis.com/auth/gmail.settings.sharing"],
    userEmail
  );
  
  jwt.authorize();
  
  return google.gmail({
    version: "v1",
    auth: jwt
  });
}

// 获取用户当前的所有发送别名
function getUserAliases(gmailService) {
  const response = gmailService.users.settings.sendAs.list({
    userId: "me" // 模拟用户后，"me"指代当前用户
  });
  
  return response.sendAs || [];
}

// 给用户添加发送别名
function addUserAlias(gmailService) {
  gmailService.users.settings.sendAs.create({
    userId: "me",
    requestBody: {
      sendAsEmail: TARGET_ALIAS.email,
      displayName: TARGET_ALIAS.displayName,
      replyToAddress: TARGET_ALIAS.email, // 可选，设置回复地址为别名
      isPrimary: false // 先设为非主，后续再改为默认
    }
  });
}

// 将目标别名设置为默认发件账户
function setAliasAsDefault(gmailService) {
  gmailService.users.settings.sendAs.patch({
    userId: "me",
    sendAsEmail: TARGET_ALIAS.email,
    requestBody: {
      isPrimary: true
    }
  });
}

关键细节说明 #

1. 服务账号模拟身份：通过JWT认证模拟域内用户或管理员身份，这是批量操作的核心，必须确保服务账号有对应的域范围委托权限
2. 重复检查：添加别名前先查询现有别名，避免重复创建导致API报错
3. API配额：如果域内用户数量较多，建议在循环中加入Utilities.sleep(1000)（暂停1秒），避免触发Gmail API的配额限制
4. 别名验证：如果是外部别名（非域内邮箱），需要先确保该邮箱已通过Gmail的验证流程，否则无法设置为默认

内容的提问来源于stack exchange，提问作者José González