如何用Node.js调用Google Calendar API实现跨平台参会者日历事件通知与添加

一、可行性与跨平台支持说明 #

• 需求完全可行：Google Calendar API原生支持创建活动时添加参会者，并通过参数触发邮件通知。参会者收到的通知邮件附带标准.ics格式文件，Outlook、iCal、Google Calendar等所有主流日历客户端都能解析该文件，将活动导入自身日历并同步提醒设置。
• 跨平台兼容核心：.ics是通用日历格式，无论参会者使用哪类邮箱/日历工具，只要能打开邮件附件，就能完成活动导入和提醒配置。

二、实现步骤 #

1. 前置准备 #

• 登录Google Cloud Console，创建项目并启用Google Calendar API。
• 创建服务账号密钥（JSON格式），将该服务账号邮箱添加到目标日历的共享列表，授予「更改和管理活动」权限。
• 安装依赖：

  npm install googleapis
  

2. 核心代码实现 #

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

// 初始化认证客户端
const auth = new google.auth.GoogleAuth({
  keyFile: path.join(__dirname, 'service-account-key.json'), // 替换为你的服务账号密钥路径
  scopes: ['https://www.googleapis.com/auth/calendar'],
});

// 创建Calendar API客户端实例
const calendar = google.calendar({ version: 'v3', auth });

// 创建活动并发送参会者通知
async function createEventWithAttendees() {
  try {
    const eventPayload = {
      summary: '跨平台协作会议',
      location: '线上会议室',
      description: '测试跨日历平台通知同步功能',
      start: {
        dateTime: '2024-12-15T14:00:00+08:00', // 替换为活动开始时间
        timeZone: 'Asia/Shanghai',
      },
      end: {
        dateTime: '2024-12-15T15:30:00+08:00', // 替换为活动结束时间
        timeZone: 'Asia/Shanghai',
      },
      attendees: [
        { email: 'user_a@gmail.com' }, // Google Calendar用户
        { email: 'user_b@outlook.com' }, // Outlook用户
        { email: 'user_c@icloud.com' }, // iCal用户
      ],
      reminders: {
        useDefault: false,
        overrides: [
          { method: 'email', minutes: 60 }, // 活动前1小时发邮件提醒（全平台生效）
          { method: 'popup', minutes: 15 }, // 活动前15分钟弹窗提醒（仅Google Calendar可见）
        ],
      },
      sendUpdates: 'all', // 关键参数：向所有参会者发送通知邮件
    };

    const response = await calendar.events.insert({
      calendarId: 'primary', // 替换为目标日历ID（共享日历需填对应ID）
      resource: eventPayload,
      sendNotifications: true, // 兼容旧版API的通知触发参数
    });

    console.log('活动创建成功，ID:', response.data.id);
    console.log('参会者通知已发送');
  } catch (err) {
    console.error('创建活动失败:', err.message);
  }
}

// 执行创建操作
createEventWithAttendees();

3. 关键参数解析 #

• sendUpdates: 'all'：强制向所有参会者发送带.ics附件的通知邮件，这是跨平台同步的核心。
• attendees：支持任何邮箱服务商的地址，无需区分日历平台。
• reminders：邮件提醒对所有平台参会者生效，弹窗提醒仅Google Calendar用户可见（其他平台可自行设置本地提醒）。

三、跨平台注意事项 #

• Outlook用户：邮件会直接显示「添加到日历」按钮，点击即可同步活动和提醒。
• iCal（iCloud）用户：打开邮件中的.ics附件，系统会自动提示添加到iCloud日历，提醒设置同步生效。
• Google Calendar用户：活动会自动添加到个人日历，同时收到邮件和日历内的双重提醒。
• 权限验证：若操作的不是服务账号自身的日历，必须确保服务账号已被添加为该日历的编辑者。

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