使用服务账号访问Google Sheets时提示Callback未定义问题求助

我前阵子也遇到过一模一样的问题！自从把Google Node.js客户端（googleapis库）更到最新版后，服务账号访问公开只读表格突然就报错了，查了半天才发现是新版本的权限逻辑做了调整。

问题根源 #

旧版本的googleapis允许服务账号“隐式”访问公开资源，哪怕你没指定权限范围也能正常请求。但新版本（大概v100+之后）优化了认证流程，要求服务账号必须显式声明权限范围，哪怕表格是全员可查看的，否则会触发权限验证失败的错误。

具体解决步骤 #

• 必须显式指定权限范围
  哪怕访问的是公开只读表格，创建JWT客户端时也要指定https://www.googleapis.com/auth/spreadsheets.readonly这个范围。之前省略这一步能跑通，但新版本不行。
• 确保认证流程完整
  不要跳过jwtClient.authorize()这一步，新版本需要完成完整的认证流程才能生成有效的请求凭证。

修正后的简化示例代码 #

const { google } = require('googleapis');

async function fetchPublicSheetData() {
  // 加载你的服务账号密钥文件
  const serviceAccountKey = require('./path-to-your-service-account-key.json');

  // 创建JWT客户端，关键是不能省略权限范围
  const jwtAuth = new google.auth.JWT(
    serviceAccountKey.client_email,
    null,
    serviceAccountKey.private_key,
    ['https://www.googleapis.com/auth/spreadsheets.readonly'], // 必须指定的范围
  );

  // 完成认证
  await jwtAuth.authorize();

  // 初始化Sheets API客户端
  const sheetsApi = google.sheets({ version: 'v4', auth: jwtAuth });

  // 替换成你的公开表格ID和数据范围
  const response = await sheetsApi.spreadsheets.values.get({
    spreadsheetId: 'YOUR_PUBLIC_SPREADSHEET_ID',
    range: 'Sheet1!A1:C10',
  });

  console.log('获取到的公开表格数据:', response.data.values);
}

// 执行函数并捕获错误
fetchPublicSheetData().catch(err => console.error('请求出错:', err));

额外提示 #

如果你的服务账号同时需要访问私有表格，只需要把权限范围改成https://www.googleapis.com/auth/spreadsheets（读写权限）即可，不需要单独创建两个客户端，同一个JWT客户端就能同时处理公开和私有表格的请求。

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