非域用户访问Web应用时，Apps Script中file.getParents().hasNext()调用失败

在以「访问Web应用的用户」上下文运行的Apps Script中，file.getParents().hasNext()调用失败，导致后续next()方法抛出迭代器耗尽的异常。

代码示例 #

function doGet() {
  var file_id = '1GYEyaak1AuQ8oxU7Po2FFjaNCdBl05qxg-PWyOO4orY';
  var parents = DriveApp.getFileById(file_id).getParents();
  console.log("getParents().hasNext(): " + parents.hasNext());
  console.log("getParents().next().getName(): " + parents.next().getName());
  return HtmlService.createHtmlOutput("DONE");
}

日志信息 #

Jun 8, 2024, 10:13:16 AM    Debug   getParents().hasNext(): false
Jun 8, 2024, 10:13:16 AM    Error   Exception: Cannot retrieve the next object: iterator has reached the end.
    at doGet(Code:5:59)

环境与权限说明 #

• 文件及父文件夹均位于MyDrive中
• 权限设置为「知道链接的互联网用户均可编辑（需登录）」，访问用户持有文件编辑权限

预期结果 #

调用file.getParents()后，hasNext()应返回true——所有文件必然存在父文件夹。

已尝试操作 #

使用域用户访问同一部署应用时，代码运行完全正常。

核心原因 #

当Web应用以「访问Web应用的用户」上下文运行时，普通外部登录用户（非域用户）即使拥有文件编辑权限，也无法通过DriveApp API获取文件的父文件夹信息。这是Google Drive的权限隔离规则：父文件夹的权限独立于文件本身，外部用户未被授予父文件夹的访问权限时，DriveApp会隐藏父文件夹的存在。

可行解决方法 #

1. 开放父文件夹权限
   给访问Web应用的外部用户添加父文件夹至少「查看者」权限，即可通过getParents()正常获取父文件夹信息。

2. 预先存储父文件夹ID
   若无法开放父文件夹权限，可直接在代码中硬编码父文件夹ID，或把父文件夹ID与文件ID关联存储在Google Sheet等位置，避免动态获取。修改示例：

   function doGet() {
     var file_id = '1GYEyaak1AuQ8oxU7Po2FFjaNCdBl05qxg-PWyOO4orY';
     var parent_folder_id = '替换为实际父文件夹ID';
     var parent_folder = DriveApp.getFolderById(parent_folder_id);
     console.log("父文件夹名称: " + parent_folder.getName());
     return HtmlService.createHtmlOutput("DONE");
   }
   

3. 改用高级Drive API
   启用Apps Script的高级Drive API，通过Drive.Files.get()可获取父文件夹ID列表（即使用户无父文件夹访问权限），再根据权限判断是否能获取文件夹名称。

   • 启用步骤：脚本编辑器 → 资源 → 高级Google服务 → 开启Drive API
   • 示例代码：

     function doGet() {
       var file_id = '1GYEyaak1AuQ8oxU7Po2FFjaNCdBl05qxg-PWyOO4orY';
       var file = Drive.Files.get(file_id, {fields: 'parents'});
       if (file.parents && file.parents.length > 0) {
         console.log("父文件夹ID: " + file.parents[0].id);
         // 尝试获取文件夹名称（需用户有父文件夹权限）
         try {
           var folder = DriveApp.getFolderById(file.parents[0].id);
           console.log("父文件夹名称: " + folder.getName());
         } catch(e) {
           console.log("无父文件夹访问权限");
         }
       } else {
         console.log("未找到父文件夹");
       }
       return HtmlService.createHtmlOutput("DONE");
     }
     

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