本文介绍如何使用 google apps script 批量从 sheet 中的 google docs/sheets 链接提取「最后修改时间」和「修改人邮箱」，并安全写入相邻列，解决列数不匹配报错问题。
本文介绍如何使用 google apps script 批量从 sheet 中的 google docs/sheets 链接提取「最后修改时间」和「修改人邮箱」，并安全写入相邻列，解决列数不匹配报错问题。
在自动化办公场景中，常需追踪共享文档的更新动态——例如确认某份合同、预算表或项目看板是否被最新编辑过，以及由谁操作。你已成功实现通过 URL 提取最后修改时间，但希望进一步获取修改人的邮箱（或姓名），并避免运行时报错 Exception: The number of columns in the data does not match the number of columns in the range。本文将为你提供完整、健壮、开箱即用的解决方案。
✅ 核心原理：Drive API 精准获取元数据
Google Sheets 原生 DriveApp.getFileById(id).getLastUpdated() 仅返回时间，不包含修改人信息。要获取 lastModifyingUser（含 emailAddress 和 displayName），必须调用 Google Drive REST API v2 的 files.get 方法——它支持细粒度字段筛选（通过 fields 参数），响应轻量且权限可控。
⚠️ 注意：此功能依赖 Drive API 已启用。请务必按以下步骤提前配置：
- 在脚本编辑器中点击 Services（服务）→ Add a service（添加服务）；
- 搜索并启用 Drive API（图标为蓝色齿轮）；
- 保存后首次运行会提示授权，同意即可。
✅ 修复后的完整脚本（推荐使用邮箱字段）
function myFunction() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
const range = sheet.getRange("H2:H" + sheet.getLastRow()); // 注意：列名大写更规范
const values = range.getRichTextValues()
.map(([cell]) => {
const link = cell.getLinkUrl();
if (!link) return [null, null]; // 空链接 → 双空值占位（保持列对齐）
// 安全提取文件 ID（兼容 docs/sheets/forms/drive 文件）
const idMatch = link.match(/\/d\/([-\w]+)/);
const id = idMatch ? idMatch[1] : null;
if (!id) return [null, null];
try {
// 调用 Drive API 获取指定字段：modifiedDate 和 emailAddress
const response = Drive.Files.get(id, {
fields: "modifiedDate,lastModifyingUser(emailAddress)"
});
const modifiedDate = response.modifiedDate
? new Date(response.modifiedDate)
: null;
const email = response.lastModifyingUser?.emailAddress || null;
return [modifiedDate, email];
} catch (e) {
console.error(`Failed to fetch metadata for ID ${id}:`, e.message);
return [null, null]; // 错误时仍返回双空值，避免写入中断
}
});
// ✅ 关键修复：明确指定目标区域维度（行数 × 列数）
// 将结果写入 I2:J{n}（即 H 列右侧两列，从第2行开始）
range.offset(0, 1, values.length, 2).setValues(values);
}? 脚本关键优化说明
| 优化点 | 说明 |
|---|---|
| ✅ 安全的 ID 提取 | 使用正则 /\/d\/([-\w]+)/ 替代 split("/")[5]，避免因 URL 格式变化（如带参数 ?usp=sharing）导致索引越界或错误 ID |
| ✅ 显式维度控制 | range.offset(0, 1, values.length, 2) 明确声明写入区域为 values.length 行 × 2 列，彻底解决报错 "data has 1 but range has 2" |
| ✅ 异常防护 | try...catch 捕获 Drive API 调用失败（如文件不存在、无访问权限、配额超限），确保单条失败不影响整体执行 |
| ✅ 空值兜底 | 所有分支均返回 [null, null]，保障 setValues() 输入数组结构统一（每行始终为 2 元素数组） |
? 使用前必读注意事项
- 权限要求：脚本需获得 https://www.googleapis.com/auth/drive.metadata.readonly 权限（启用 Drive API 后自动申请）；
- 文件可见性：仅能获取当前用户有查看权限的文件元数据。若链接指向私有文件且你无权访问，API 将抛出 403 错误；
-
列映射建议：
- H2:H：输入列（含超链接的 Google 文档 URL）；
- I2:I：自动填充「最后修改时间」（日期格式，可设单元格格式为 yyyy-mm-dd hh:mm:ss）；
- J2:J：自动填充「修改人邮箱」（纯文本）；
- 如需显示姓名而非邮箱：将 lastModifyingUser(emailAddress) 改为 lastModifyingUser(displayName)，并把 response.lastModifyingUser?.emailAddress 替换为 response.lastModifyingUser?.displayName；
- 批量性能：该脚本为同步调用，处理数百行通常在 10 秒内完成；若需处理上千行，建议分批调用或改用 UrlFetchApp + 批处理（进阶场景）。
? 总结
通过启用 Drive API 并采用结构化字段请求（fields），我们不仅能可靠获取修改时间与邮箱，更能以工程化方式规避常见运行时错误。本方案兼顾新手友好性（清晰注释、防错逻辑）与生产可用性（权限、性能、日志）。只需三步：启用 API → 粘贴脚本 → 运行 myFunction，即可实现文档更新责任到人的自动化审计。
