如何通过Google Form API更新权限或添加表单编辑权限邮箱？

核心问题澄清 #

• Google Forms API 本身不提供权限管理接口，表单的权限配置需要通过Google Drive API完成
• 服务账号创建的表单默认仅服务账号自身拥有访问权限，这是导致外部用户无法打开链接的直接原因

正确的权限配置实现 #

替换你之前错误调用的forms.permissions.update，改用Drive API的权限接口来添加用户编辑权限：

// 给指定邮箱添加表单编辑权限
async function addFormEditPermission(formId, targetEmail) {
  try {
    await authClient.authorize();
    const drive = google.drive({ version: 'v3', auth: authClient });
    
    const res = await drive.permissions.create({
      fileId: formId,
      requestBody: {
        role: 'writer',       // 授予编辑权限
        type: 'user',
        emailAddress: targetEmail,
        sendNotificationEmail: true  // 可选：自动发送权限通知邮件
      },
      fields: 'id'
    });
    console.log(`权限添加成功，权限ID：${res.data.id}`);
  } catch (err) {
    console.error('权限添加失败:', err);
  }
}

修复表单链接无法访问问题 #

如果需要让外部用户能打开表单链接，除了给特定用户加权限，还可以根据需求设置公开访问（或限制到指定用户）：

// 设置表单为任何人可查看（按需调整role为writer/reader）
async function setFormPublicAccess(formId) {
  try {
    await authClient.authorize();
    const drive = google.drive({ version: 'v3', auth: authClient });
    
    await drive.permissions.create({
      fileId: formId,
      requestBody: {
        role: 'reader',
        type: 'anyone',
        allowFileDiscovery: false
      }
    });
    console.log('表单已设置为公开可访问');
  } catch (err) {
    console.error('公开访问设置失败:', err);
  }
}

完整整合代码示例 #

将权限操作整合到表单创建流程中：

const {google} = require('googleapis');
const {JWT} = require('google-auth-library');

// 替换为你的服务账号凭据
const CLIENT_EMAIL = '你的服务账号邮箱';
const PRIVATE_KEY = '你的服务账号私钥';
const FORM_NAME = 'My Form';
const QUESTION_TITLE = 'What is your favorite color?';
const QUESTION_CHOICES = ['Red', 'Green', 'Blue'];
const TARGET_EMAIL = '需要添加权限的用户邮箱';

// 初始化JWT客户端，必须包含Drive API权限范围
const authClient = new JWT({
  email: CLIENT_EMAIL,
  key: PRIVATE_KEY,
  scopes: [
    'https://www.googleapis.com/auth/forms',
    'https://www.googleapis.com/auth/drive',  // 核心：Drive权限必须添加
    'https://www.googleapis.com/auth/forms.body'
  ]
});

async function createFormWithPermissions() {
  try {
    await authClient.authorize();

    // 创建表单
    const forms = google.forms({version: 'v1', auth: authClient});
    const formRes = await forms.forms.create({
      resource: {
        info: {
          title: FORM_NAME,
          documentTitle: QUESTION_TITLE
        }
      }
    });
    const formId = formRes.data.formId;
    console.log(`表单创建完成，ID：${formId}`);

    // 添加选择题
    await forms.forms.batchUpdate({
      formId: formId,
      resource: {
        requests: [{
          createItem: {
            item: {
              title: QUESTION_TITLE,
              questionItem: {
                question: {
                  required: true,
                  choiceQuestion: {
                    type: "RADIO",
                    options: QUESTION_CHOICES.map(opt => ({ value: opt }))
                  }
                }
              }
            },
            location: { index: 0 }
          }
        }]
      }
    });

    // 给目标用户添加编辑权限
    const drive = google.drive({ version: 'v3', auth: authClient });
    await drive.permissions.create({
      fileId: formId,
      requestBody: {
        role: 'writer',
        type: 'user',
        emailAddress: TARGET_EMAIL,
        sendNotificationEmail: true
      }
    });
    console.log(`已为${TARGET_EMAIL}添加表单编辑权限`);

    // 可选：设置表单公开访问
    // await setFormPublicAccess(formId);

  } catch (err) {
    console.error('操作失败:', err);
  }
}

createFormWithPermissions();

关键注意事项 #

• 权限范围：必须包含https://www.googleapis.com/auth/drive或https://www.googleapis.com/auth/drive.file，否则无法操作Drive权限
• API启用：确保在Google Cloud控制台中已启用Google Drive API和Google Forms API
• 组织限制：如果你的域名有共享权限限制，需联系管理员允许服务账号向外部用户共享资源

内容的提问来源于stack exchange，提问作者Ratanon-63015144