如何在Google Apps Script中发起Gmail API批量请求？线程查询场景示例

首先得明确：Google Apps Script里的Gmail高级服务没有像JavaScript客户端那样的gapi.client.newBatch()方法，不过我们可以通过其他方式实现类似的批量操作，先从基础的准备步骤说起：

第一步：启用Gmail v1高级服务 #

要在Apps Script里使用Gmail API，得先开启高级服务：

• 打开你的Apps Script项目
• 点击左侧菜单栏的「服务」→「添加服务」
• 在弹出的列表里找到「Gmail API」，选择版本v1，点击「添加」即可

实现批量操作的两种方式 #

方式1：用Promise并行请求（简单易维护） #

这种方式适合大多数场景，利用V8引擎的Promise特性，同时发起多个Gmail.Users.Threads.get()请求，模拟批量操作的效果：

function getAndBatchFetchThreads() {
  // 先获取目标线程列表（这里取当前用户前10个线程，可按需调整参数）
  const threadList = Gmail.Users.Threads.list('me', { maxResults: 10 });
  const threadIds = (threadList.threads || []).map(thread => thread.id);

  if (threadIds.length === 0) {
    console.log("没找到任何线程");
    return;
  }

  // 构造并行请求的Promise数组
  const threadDetailPromises = threadIds.map(threadId => {
    return new Promise((resolve, reject) => {
      try {
        const thread = Gmail.Users.Threads.get('me', threadId);
        resolve(thread);
      } catch (err) {
        reject(`获取线程${threadId}失败：${err.message}`);
      }
    });
  });

  // 等待所有请求完成
  Promise.all(threadDetailPromises)
    .then(details => {
      console.log("批量获取到的线程详情：", details);
      // 这里可以添加你的业务逻辑，比如提取邮件内容、写入表格等
    })
    .catch(err => {
      console.error("批量请求出错：", err);
    });
}

方式2：直接调用Gmail批量API端点（更高效） #

如果你的线程数量很大，想减少HTTP请求次数，可以直接用UrlFetchApp调用Gmail的批量API端点，手动构造批量请求体：

function batchFetchViaUrlFetch() {
  const threadIds = ["thread-id-1", "thread-id-2"]; // 替换为实际的线程ID列表
  const batchRequests = threadIds.map((id, idx) => ({
    method: "GET",
    id: `req-${idx}`,
    url: `https://gmail.googleapis.com/gmail/v1/users/me/threads/${id}`
  }));

  const payload = JSON.stringify({ requests: batchRequests });
  const options = {
    method: "POST",
    contentType: "application/json",
    headers: { Authorization: `Bearer ${ScriptApp.getOAuthToken()}` },
    payload: payload,
    muteHttpExceptions: true
  };

  const response = UrlFetchApp.fetch("https://gmail.googleapis.com/batch/gmail/v1", options);
  const responseText = response.getContentText();
  
  // 注意：批量响应是multipart/mixed格式，需要手动解析内容
  console.log("批量API响应：", responseText);
}

一些注意事项 #

• 启用高级服务后，Apps Script会自动处理OAuth授权，无需手动管理令牌（用UrlFetchApp的情况除外，需要调用ScriptApp.getOAuthToken()）
• 注意Gmail API的配额限制，每日调用有上限，批量操作时要避免一次性请求过多线程
• 如果线程数量过百，建议分批次处理（比如每次处理50个），避免脚本超时

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