Gmail：获取代持账户（别名）中指定标签的邮件会话数量

原理说明 #

Google Apps Script中的GmailApp服务仅能访问当前授权用户的个人邮箱，无法直接读取群组收件箱（别名账户）的邮件数据。要访问共享的群组邮箱，必须使用Gmail API——它允许指定目标邮箱地址作为userId参数，只要当前授权账户拥有该群组邮箱的访问权限（比如是群组成员），就能查询其邮件、标签等内容。

实现步骤 #

1. 启用Gmail API #

在脚本编辑器中：

• 点击左侧菜单栏的「服务」（Services）
• 点击「添加服务」，找到「Gmail API」，将状态设为「启用」后保存

2. 修改脚本代码 #

替换原脚本中GmailApp相关逻辑，改用Gmail API查询目标群组邮箱的邮件：

function countEmailwLabelsEnterprise() {
  var tss = SpreadsheetApp.getActive();
  var dailyUpdateCalcSht = tss.getSheetByName('Daily Update Calculator');

  // 从表格读取目标标签名称
  var labelName = dailyUpdateCalcSht.getRange('B32').getValue();
  // 读取群组别名邮箱地址（也可直接硬编码，比如"group-inbox@yourdomain.com"）
  var groupEmail = dailyUpdateCalcSht.getRange('B33').getValue(); // 建议把邮箱存在表格单元格，方便修改

  // 处理标签名含空格的情况，给标签名加双引号
  var query = 'label:"' + labelName + '"';

  // 调用Gmail API查询带指定标签的邮件线程
  var response = Gmail.Users.Threads.list(groupEmail, {
    q: query,
    maxResults: 1000 // 单次查询最多返回1000条，若数量超过需分页（见下方补充）
  });

  // 统计线程数量（无匹配线程时response.threads为undefined）
  var threadCount = response.threads ? response.threads.length : 0;
  dailyUpdateCalcSht.getRange('B13').setValue(threadCount);
}

3. 处理大量邮件（可选） #

如果目标标签下的邮件超过1000条，需要通过分页获取全部数据，修改后的代码如下：

function countEmailwLabelsEnterprise() {
  var tss = SpreadsheetApp.getActive();
  var dailyUpdateCalcSht = tss.getSheetByName('Daily Update Calculator');

  var labelName = dailyUpdateCalcSht.getRange('B32').getValue();
  var groupEmail = dailyUpdateCalcSht.getRange('B33').getValue();
  var query = 'label:"' + labelName + '"';

  var threadCount = 0;
  var pageToken = null;

  do {
    var response = Gmail.Users.Threads.list(groupEmail, {
      q: query,
      maxResults: 1000,
      pageToken: pageToken
    });
    if (response.threads) {
      threadCount += response.threads.length;
    }
    pageToken = response.nextPageToken;
  } while (pageToken);

  dailyUpdateCalcSht.getRange('B13').setValue(threadCount);
}

注意事项 #

• 确保授权账户拥有目标群组收件箱的访问权限（比如已加入该群组，能在Gmail中查看群组邮件）
• 标签名称需与群组邮箱中的实际标签完全一致（包括空格、特殊字符）
• 首次运行脚本时，需要完成Gmail API的权限授权流程

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