NodeJS调用Google Calendar API触发未认证限额错误，求配置方案

我之前也碰到过一模一样的问题，其实这个错误的核心原因很明确：你的API请求没有正确携带有效的认证凭证，Google把这类无凭证的请求归为「未认证调用」，这类调用的限额极低（和文档里提到的100万次/日的认证调用限额完全是两回事），哪怕你测试只调用几十次也会触发这个错误。结合你已经拿到API Key、client_id等凭证的情况，我分两种场景给你讲具体配置方法：

场景1：访问公开日历数据（无需用户授权）—— 使用API Key #

如果你的需求只是读取公开日历的信息，API Key就足够用了，正确的使用方式是：

• 在API请求的Query参数中携带API Key：比如在Node.js中用axios发起请求时，要把key参数加到请求URL的查询串里：

const axios = require('axios');

async function getPublicCalendarEvents() {
  try {
    const response = await axios.get('https://www.googleapis.com/calendar/v3/calendars/{公开日历ID}/events', {
      params: {
        key: '你的API Key' // 替换成你从控制台拿到的API Key
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error.response.data);
  }
}

• 额外配置：确保API Key绑定了Google Calendar API：
  1. 打开Google Cloud控制台，进入「API和服务」->「凭据」
  2. 找到你的API Key，点击编辑
  3. 在「API限制」部分，选择「限制键」，然后从下拉列表中勾选「Google Calendar API」
  4. 测试阶段可以暂时不设置「应用限制」（比如IP或HTTP引用者限制），避免额外的权限拦截

场景2：访问用户私有日历数据（需要用户授权）—— 使用OAuth 2.0 #

如果你的应用需要读写用户的私有日历，API Key就不够了，必须使用你已有的client_id、client_secret走OAuth 2.0授权流程，推荐使用官方的googleapis库简化开发：

1. 先安装依赖：

npm install googleapis

2. 示例代码实现授权和API调用：

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

// 初始化OAuth2客户端
const oauth2Client = new google.auth.OAuth2(
  '你的client_id',
  '你的client_secret',
  'http://localhost:3000/oauth2callback' // 这个地址要和你在控制台凭据里设置的「重定向URI」完全一致
);

// 生成授权URL，引导用户访问并授权
function generateAuthUrl() {
  const authUrl = oauth2Client.generateAuthUrl({
    access_type: 'offline', // 允许获取刷新令牌，方便后续无用户交互时调用
    scope: ['https://www.googleapis.com/auth/calendar'] // 根据需求选权限，只读可用`calendar.readonly`
  });
  console.log('请访问此URL授权:', authUrl);
}

// 用户授权后拿到code，交换为访问令牌并调用API
async function fetchCalendarEvents(code) {
  try {
    // 交换令牌
    const { tokens } = await oauth2Client.getToken(code);
    oauth2Client.setCredentials(tokens);

    // 初始化Calendar API客户端
    const calendar = google.calendar({ version: 'v3', auth: oauth2Client });

    // 调用API获取用户主日历的事件
    const response = await calendar.events.list({
      calendarId: 'primary',
      timeMin: new Date().toISOString(),
      maxResults: 10,
      singleEvents: true,
      orderBy: 'startTime'
    });

    console.log('日历事件:', response.data.items);
  } catch (error) {
    console.error('API调用错误:', error.message);
  }
}

// 先调用generateAuthUrl()获取授权URL，用户授权后拿到code再调用fetchCalendarEvents(code)
// generateAuthUrl();
// fetchCalendarEvents('用户授权后拿到的code');

关于「额外注册」的疑问 #

你不需要通过CLI工具完成额外注册，但必须确认Google Calendar API已经在你的项目中启用：

1. 打开Google Cloud控制台，进入「API和服务」->「库」
2. 搜索「Google Calendar API」，点击进入详情页
3. 如果显示「启用」按钮，说明还没启用，点击启用即可；如果显示「管理」，说明已经启用完成

常见排查点 #

• 检查API请求中是否确实携带了正确的凭证（API Key或OAuth令牌），不要遗漏
• 确认控制台中的凭证配置（API Key的限制、OAuth的重定向URI）和代码中的配置完全一致
• 如果使用OAuth，确保用户授权的权限范围和你调用API时需要的权限匹配

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