如何用Node.js通过服务账号连接Google Calendar API并自动授权添加Meet链接

一、服务账号准备 #

• 在Google Cloud Console中创建服务账号，下载生成的JSON密钥文件（保存为service-account-key.json）
• 若目标用户属于Google Workspace（原G Suite）域，需由域管理员在Admin Console中配置域范围授权：
  • 为服务账号添加Calendar API相关权限（如https://www.googleapis.com/auth/calendar.events，根据需求选择读写权限）
  • 指定服务账号可 impersonate 的目标用户邮箱

二、替换手动OAuth认证为服务账号JWT认证 #

安装依赖：

npm install googleapis

改造原google-util.js的认证逻辑，替换为服务账号认证：

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

// 服务账号密钥文件路径
const KEYFILE_PATH = path.join(__dirname, 'service-account-key.json');
// 授权范围：根据需求调整，这里需要日历事件读写权限
const SCOPES = ['https://www.googleapis.com/auth/calendar.events'];
// 要代表操作的客户邮箱（需域管理员授权）
const TARGET_USER_EMAIL = 'customer@your-domain.com';

// 初始化JWT认证客户端
const authClient = new google.auth.JWT(
  null, // 自动从密钥文件读取服务账号邮箱
  KEYFILE_PATH,
  null,
  SCOPES,
  TARGET_USER_EMAIL // 关键：指定要 impersonate 的用户
);

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

三、创建带Google Meet链接的日历事件 #

添加事件创建函数，自动生成并关联Meet链接：

async function createEventWithMeet() {
  try {
    const eventPayload = {
      summary: '客户专属会议',
      description: '通过Google Meet开展的线上沟通',
      start: {
        dateTime: '2024-06-15T14:30:00+08:00',
        timeZone: 'Asia/Shanghai',
      },
      end: {
        dateTime: '2024-06-15T15:30:00+08:00',
        timeZone: 'Asia/Shanghai',
      },
      // 配置Meet链接生成
      conferenceData: {
        createRequest: {
          requestId: `meet-${Date.now()}`, // 唯一ID，避免重复请求
          conferenceSolutionKey: { type: 'hangoutsMeet' }
        }
      },
      attendees: [{ email: 'participant@example.com' }] // 可选：添加参会人
    };

    const response = await calendarApi.events.insert({
      calendarId: 'primary', // 操作目标用户的主日历
      resource: eventPayload,
      conferenceDataVersion: 1 // 必须设置为1才能启用Meet链接生成
    });

    console.log('事件创建完成，Meet链接:', response.data.hangoutLink);
    return response.data;
  } catch (err) {
    console.error('创建事件失败:', err.message);
    throw err;
  }
}

// 执行事件创建
createEventWithMeet();

四、关键注意事项 #

• 服务账号仅支持操作Google Workspace域内用户，普通Gmail账号无法通过此方式授权（无域管理员权限配置）
• 密钥文件需妥善保管，禁止提交到公共代码仓库
• 域范围授权的权限需与业务需求匹配，避免过度授权
• requestId必须保证唯一，否则可能导致Meet链接重复或创建失败

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