cURL调用Google Apps Script文档合并函数的参数配置与报错解决

报错核心诱因 #

碰到“文档缺失/无读取权限”的返回，本质是两类问题，和文档本身是否被删除无关：

• 身份权限错配：本地在脚本编辑器测试时，脚本运行身份是你本人的Google账号，自然对两个测试文档有完整读取权限；若部署API时选择的执行身份不是文档所属账号，或外部请求携带的OAuth凭证没有对应文档的读取范围权限，就会触发接口找不到文档的报错。
• 参数传值格式错误：新手常把文档ID直接放在请求体的顶级字段，而非按Apps Script API要求放在parameters数组内，导致函数收到空值/错误值，传入Docs API后自然匹配不到有效文档。

前置配置校验 #

调整部署参数避免权限类报错：

• 重新部署脚本，选择执行身份为 以文档所属账号的身份运行，直接继承你对所有待操作文档的权限，从根源解决权限不足问题。
• 确认外部cURL使用的Bearer Token，是和文档所属账号关联的有效凭证，且Token覆盖https://www.googleapis.com/auth/documents的文档读写权限范围，不存在权限不足问题。

可直接复用的cURL请求模板 #

替换对应占位符即可直接运行，不要随意修改请求结构：

curl --request POST \
  "https://script.googleapis.com/v1/scripts/你的脚本部署ID:run" \
  --header "Authorization: Bearer 你生成的有效OAuth访问令牌" \
  --header "Content-Type: application/json" \
  --data '{
    "function": "mergeGoogleDocs",
    "parameters": ["第一个文档的完整ID", "第二个文档的完整ID"],
    "devMode": false
  }'

传值注意事项 #

• 两个文档ID必须按函数定义的入参顺序放在parameters数组内，不要将ID作为独立顶级字段放在请求体中，否则函数无法读取到传入的参数值。
• 文档ID直接提取文档链接中/d/后的30位左右字符串即可，不要把完整文档链接、带斜杠的路径片段当ID传入。
• 确认OAuth令牌未过期，若令牌生成时未勾选Docs相关权限范围，即便ID传值正确也会触发权限类报错。

快速定位问题的调试方法 #

如果调整后仍报错，可在mergeGoogleDocs函数的逻辑最开头加入日志打印实际接收到的参数：

function mergeGoogleDocs(docA, docB) {
  console.log("接收到的第一个文档ID：" + docA);
  console.log("接收到的第二个文档ID：" + docB);
  // 原有合并文档的业务逻辑
}

发起一次cURL调用后，查看Apps Script的执行日志：

• 若打印的ID和预期传入的不一致，说明是参数传值格式错误，调整JSON结构即可。
• 若打印的ID完全正确仍报权限错误，说明当前脚本运行身份、请求携带的凭证，没有对应文档的读取权限，需调整部署身份或重新生成对应权限范围的OAuth令牌。

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