Node.js调用Google Sheets API可读取但无法创建表格的权限问题

核心代码错误：重复初始化认证对象 #

你的create函数里重新创建了GoogleAuth实例，没有使用authorize()返回的已授权客户端，这是导致权限不匹配的主要原因。修正方法是直接使用authorize()传递的auth参数，不要在函数内重新初始化认证。

修正后的create函数代码 #

/**
 * Create a google spreadsheet
 * @param {google.auth.OAuth2} auth 已认证的OAuth客户端
 * @param {string} title Spreadsheets title
 * @return {string} Created spreadsheets ID
 */
async function create(auth, title = "New Spreadsheet") {
  const { google } = require('googleapis');

  const service = google.sheets({ version: 'v4', auth });
  const resource = {
    properties: {
      title,
    },
    // 如果用服务账号，指定已共享的父文件夹ID，让个人账号能直接看到
    // parents: ['你的共享文件夹ID']
  };
  try {
    const spreadsheet = await service.spreadsheets.create({
      resource,
      fields: 'spreadsheetId',
    });
    console.log(`Spreadsheet ID: ${spreadsheet.data.spreadsheetId}`);
    return spreadsheet.data.spreadsheetId;
  } catch (err) {
    throw err;
  }
}

// 调用时传递auth参数
authorize().then(auth => create(auth)).catch(console.error);

不同认证方式的额外注意事项 #

OAuth2 Client ID 场景

• 确保SCOPES常量包含https://www.googleapis.com/auth/spreadsheets，如果之前授权时没有请求这个权限，需要删除本地保存的凭据文件，重新运行程序获取新授权。
• 授权时确认用户账号同意了"查看、编辑、创建和删除电子表格"的权限。

服务账号场景

• 确认服务账号的密钥文件路径正确，SCOPES包含https://www.googleapis.com/auth/spreadsheets或https://www.googleapis.com/auth/drive（后者权限更全）。
• 如果需要个人Gmail账号能访问创建的表格，要么：
  • 在创建表格时通过parents参数指定已共享给服务账号的文件夹ID（你已经给文件夹赋权，直接填ID即可）；
  • 创建完成后调用Google Drive API，将表格共享给你的个人账号。
• 检查服务账号邮箱是否被添加到目标文件夹的共享列表，权限至少设为"编辑者"。

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