如何通过Google Picker API为GAS应用授予指定Drive文件夹的权限？

嘿，这个问题我之前帮不少开发者踩过坑，核心点在于：Google Picker只是帮用户选择文件夹，但不会自动把该文件夹的权限授予你的GAS应用。要解决这个，咱们得结合Google推荐的最小权限范围，再配合Picker和权限授予逻辑来实现，既满足OAuth审核要求，又能让用户顺利授权。

1. 先配置合规的OAuth范围 #

首先别用全Drive访问的大范围了，Google OAuth审核肯定卡你。咱们用drive.file这个受限范围——它允许应用访问用户明确授权的文件/文件夹，或者应用自己创建的资源，完全符合Google的最小权限原则。

配置步骤：

• 在GAS脚本编辑器里，点击右上角的「项目设置」
• 勾选「显示“appsscript.json”清单文件」
• 打开appsscript.json，把oauthScopes改成下面这样：

"oauthScopes": [
  "https://www.googleapis.com/auth/drive.file",
  "https://www.googleapis.com/auth/script.container.ui"
]

• drive.file：核心权限，用于访问用户授权的文件夹
• script.container.ui：用于弹出Picker的弹窗界面

2. 实现Google Picker的前端界面 #

Picker需要在网页弹窗里运行（GAS脚本端没法直接调用），咱们创建一个HTML文件来承载它：

新建一个HTML文件（命名为Picker.html），粘贴下面的代码：

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script type="text/javascript">
      // 加载Picker API
      function loadPicker() {
        gapi.load('picker', {'callback': initPicker});
      }

      function initPicker() {
        // 只允许选择文件夹的视图
        const folderView = new google.picker.DocsView(google.picker.ViewId.FOLDERS)
          .setSelectFolderEnabled(true);

        const picker = new google.picker.PickerBuilder()
          .addView(folderView)
          .setOAuthToken('<?= ScriptApp.getOAuthToken() ?>')
          .setDeveloperKey('YOUR_API_KEY') <!-- 替换成你的Google Cloud API密钥 -->
          .setCallback(pickerCallback)
          .build();
        picker.setVisible(true);
      }

      // 用户选择文件夹后的回调
      function pickerCallback(data) {
        if (data[google.picker.Response.ACTION] === google.picker.Action.PICKED) {
          const selectedFolder = data[google.picker.Response.DOCUMENTS][0];
          const folderId = selectedFolder[google.picker.Document.ID];
          // 把文件夹ID传回GAS脚本处理
          google.script.run.withSuccessHandler(() => {
            alert('文件夹已选中！接下来会自动为应用授权，若失败请手动操作~');
            google.script.host.close();
          }).handleFolderSelection(folderId);
        }
      }
    </script>
  </head>
  <body onload="loadPicker()">
  </body>
</html>

⚠️ 注意：YOUR_API_KEY需要你去Google Cloud控制台创建一个API密钥，并且启用「Google Picker API」。

3. GAS脚本端的核心逻辑 #

回到Code.gs，写弹出Picker、处理文件夹授权的代码：

// 弹出Picker选择文件夹的弹窗
function showFolderPicker() {
  const htmlDialog = HtmlService.createHtmlOutputFromFile('Picker')
    .setWidth(600)
    .setHeight(400);
  // 如果是绑定到表格的脚本用SpreadsheetApp，独立脚本用UiApp或者其他容器的UI
  SpreadsheetApp.getUi().showModalDialog(htmlDialog, '选择要授权的Drive文件夹');
}

// 处理Picker传回的文件夹ID，尝试自动授权
function handleFolderSelection(folderId) {
  // 把文件夹ID存在用户属性里，方便后续调用
  PropertiesService.getUserProperties().setProperty('AUTHORIZED_FOLDER_ID', folderId);
  
  // 获取GAS应用的服务邮箱（就是用来接收权限的邮箱）
  const scriptServiceEmail = Session.getEffectiveUser().getEmail();
  
  try {
    // 调用Drive API给应用邮箱添加文件夹的编辑权限
    Drive.Permissions.insert(
      {
        role: 'writer', // 可以改成reader（只读），根据你的需求来
        type: 'user',
        value: scriptServiceEmail
      },
      folderId,
      { sendNotificationEmails: false } // 可选：是否给用户发通知邮件
    );
    SpreadsheetApp.getUi().alert('权限授权成功！现在可以操作该文件夹了~');
  } catch (error) {
    // 如果用户没有文件夹的管理权限（比如是别人共享的文件夹），自动授权会失败
    SpreadsheetApp.getUi().alert(`自动授权失败，请手动操作：\n1. 打开选中的Drive文件夹\n2. 点击「共享」按钮\n3. 输入邮箱：${scriptServiceEmail}\n4. 授予「编辑」权限`);
  }
}

// 测试函数：验证是否能在授权文件夹创建文件
function testCreateFileInFolder() {
  const folderId = PropertiesService.getUserProperties().getProperty('AUTHORIZED_FOLDER_ID');
  if (!folderId) {
    SpreadsheetApp.getUi().alert('请先选择并授权文件夹！');
    return;
  }
  const targetFolder = DriveApp.getFolderById(folderId);
  targetFolder.createFile('GAS测试文件.txt', '这是通过GAS创建的测试内容');
  SpreadsheetApp.getUi().alert('测试文件已成功创建！权限验证通过~');
}

关键细节提醒 #

• 自动授权的前提：用户必须是该文件夹的所有者或者拥有管理权限，否则没法添加新的共享用户，这时候就需要引导用户手动授权。
• 脚本服务邮箱在哪里找？你可以在GAS脚本编辑器的「项目设置」里找到那个类似xxxx@xxxx.iam.gserviceaccount.com的邮箱，或者直接用Session.getEffectiveUser().getEmail()获取。
• OAuth审核：用drive.file范围提交审核，只要你在审核说明里清楚描述“用户选择文件夹后，应用需要访问该文件夹创建文件”，基本上都能通过。

备注：内容来源于stack exchange，提问作者出口政孝