Google Calendar API：网站如何无需登录即可访问指定Google日历？

这个问题其实很典型——你之前用的是用户侧OAuth授权模式，依赖你的个人Google账号登录获取令牌，自然只能在你登录时正常工作。要实现网站无需绑定你的账号、甚至无需用户登录就能访问指定Google Calendar，核心是切换到**服务账号（Service Account）**认证方案，这是Google专为服务器端无交互场景设计的认证方式。

具体实现步骤 #

1. 创建并配置服务账号 #

• 打开Google Cloud控制台，找到你的项目（没有就新建一个）。
• 进入「IAM与管理」→「服务账号」，点击「创建服务账号」，填写基础信息后完成创建。
• 给服务账号分配权限：如果只需要读取日历，添加「Calendar Viewer」角色；需要编辑/修改的话，选择「Calendar Editor」或更高权限的角色。
• 生成认证密钥：进入服务账号详情页的「密钥」标签，点击「添加密钥」→「创建新密钥」，选择JSON格式下载密钥文件（务必妥善保管，别提交到代码仓库）。

2. 共享目标日历给服务账号 #

服务账号本质是一个特殊的Google账号，你需要把要访问的Calendar共享给它：

• 打开Google Calendar，找到目标日历的「设置和共享」。
• 在「共享特定人员」里添加服务账号的邮箱（格式类似xxx@xxx.iam.gserviceaccount.com，可在服务账号详情页找到），并赋予对应权限（比如编辑权限）。

3. 改造服务器端代码使用服务账号认证 #

替换之前的OAuth授权逻辑，用服务账号密钥生成访问令牌。以Node.js为例，使用官方googleapis库的示例代码如下：

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

// 加载服务账号密钥文件
const auth = new google.auth.GoogleAuth({
  keyFile: './your-service-account-key.json', // 替换为你的密钥文件路径
  scopes: ['https://www.googleapis.com/auth/calendar'], // 根据需求选对应权限范围
});

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

// 示例：获取日历事件
async function fetchCalendarEvents() {
  const response = await calendar.events.list({
    calendarId: 'your-target-calendar-id@group.calendar.google.com', // 替换为目标日历ID
    timeMin: new Date().toISOString(),
    maxResults: 10,
    singleEvents: true,
    orderBy: 'startTime',
  });
  console.log('获取到的事件:', response.data.items);
}

fetchCalendarEvents();

4. 关键注意事项 #

• 最小权限原则：只给服务账号分配必要的权限，避免过度授权带来安全风险。
• 日历可见性：确保目标日历的共享设置正确，不要设为仅自己可见，否则服务账号无法访问。
• 密钥安全：密钥文件包含服务账号的核心认证信息，建议用环境变量或密钥管理服务存储，不要直接硬编码在代码中。

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