如何使用Google NodeJS OAuth2 Client获取日历事件

我正在使用Google官方的google-api-nodejs-client库，已初始化OAuth2客户端，但仅能输出客户端基本信息，不清楚如何通过该客户端获取指定日历的事件列表。现有资料多基于gapi，与我采用的官方库用法不符。

补充：尝试使用auth.getClient()时提示无法加载默认凭证，希望直接在代码中指定凭证，无需执行gcloud auth application-default login命令行操作。

当前代码：

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

const oauth2Client = new google.auth.OAuth2(
    "MY_CLIENT_ID",
    "MY_CLIENT_SECRET",
    "http://localhost:3000"
);

export default function handler(req, res) {
    res.status(200).json(oauth2Client);
}

1. 先完成OAuth2授权流程，获取有效凭证 #

当前的oauth2Client仅完成了基础初始化，未获取用户授权的访问凭证（access_token、refresh_token），需先完成授权流程：

生成授权URL并引导用户授权 #

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

const oauth2Client = new google.auth.OAuth2(
    "MY_CLIENT_ID",
    "MY_CLIENT_SECRET",
    "http://localhost:3000"
);

// 日历API权限范围，按需调整：readonly为只读，calendar为读写
const scopes = ['https://www.googleapis.com/auth/calendar.readonly'];

// 生成授权URL，offline模式用于获取refresh_token支持离线刷新
const authUrl = oauth2Client.generateAuthUrl({
    access_type: 'offline',
    scope: scopes
});

// 处理授权回调，用授权码交换凭证
export default async function handler(req, res) {
    if (req.query.code) {
        // 用授权码获取tokens
        const { tokens } = await oauth2Client.getToken(req.query.code);
        oauth2Client.setCredentials(tokens);
        // 建议将tokens存储到数据库，后续可复用
        res.redirect('/api/get-calendar-events'); // 跳转到获取事件的接口
    } else {
        // 引导用户访问授权URL
        res.redirect(authUrl);
    }
}

2. 使用授权后的客户端调用日历API获取事件 #

凭证设置完成后，创建日历API实例并调用events.list方法：

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

const oauth2Client = new google.auth.OAuth2(
    "MY_CLIENT_ID",
    "MY_CLIENT_SECRET",
    "http://localhost:3000"
);

// 从数据库或其他存储中读取已保存的tokens
oauth2Client.setCredentials({
    access_token: 'USER_ACCESS_TOKEN',
    refresh_token: 'USER_REFRESH_TOKEN',
    expiry_date: TOKEN_EXPIRY_TIMESTAMP // 可选，客户端会自动刷新过期凭证
});

export default async function handler(req, res) {
    try {
        // 初始化日历API客户端
        const calendar = google.calendar({ version: 'v3', auth: oauth2Client });
        
        // 调用API获取事件
        const response = await calendar.events.list({
            calendarId: 'primary', // 替换为目标日历ID，比如用户邮箱或共享日历ID
            timeMin: new Date().toISOString(), // 仅获取当前时间之后的事件
            maxResults: 10, // 限制返回事件数量
            singleEvents: true, // 将重复事件拆分为单个条目
            orderBy: 'startTime' // 按开始时间排序
        });

        res.status(200).json(response.data.items);
    } catch (error) {
        res.status(500).json({ error: error.message });
    }
}

关于默认凭证的替代方案 #

如果你的场景是无需用户交互的服务端任务（比如同步企业共享日历），可以使用服务账号凭证代替OAuth2授权，无需依赖gcloud命令行设置：

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

// 从Google Cloud控制台下载服务账号密钥文件
const serviceAccountKey = './service-account-key.json';

// 初始化服务账号授权客户端
const auth = new JWT({
    keyFile: serviceAccountKey,
    scopes: ['https://www.googleapis.com/auth/calendar.readonly'],
    subject: 'target-user@example.com' // 若访问特定用户的日历，需指定该用户邮箱（需提前授权服务账号访问）
});

export default async function handler(req, res) {
    try {
        const calendar = google.calendar({ version: 'v3', auth });
        const response = await calendar.events.list({
            calendarId: 'primary',
            timeMin: new Date().toISOString(),
            maxResults: 10,
            singleEvents: true,
            orderBy: 'startTime'
        });

        res.status(200).json(response.data.items);
    } catch (error) {
        res.status(500).json({ error: error.message });
    }
}

内容的提问来源于stack exchange，提问作者Ryan.Jones