Google API Node.js 客户端中服务账号创建带参与者的日历事件解决方案

2025-05-19 01:07:32作者：段琳惟

在使用 Google API Node.js 客户端（googleapis/google-api-nodejs-client）时，开发者可能会遇到使用服务账号创建带有参与者的日历事件时出现权限错误的问题。本文将深入分析问题原因并提供完整的解决方案。

问题背景

当开发者尝试通过 Google 服务账号创建包含参与者的日历事件时，通常会收到错误提示："Service accounts cannot invite attendees without Domain-Wide Delegation of Authority"。这个错误表明服务账号缺少必要的域范围授权。

核心问题分析

服务账号默认情况下无法直接代表用户执行操作，特别是涉及邀请其他参与者的日历操作。这需要配置域范围授权（Domain-Wide Delegation），使服务账号能够代表特定用户执行操作。

完整解决方案

1. 准备工作

首先确保已创建服务账号并下载 JSON 密钥文件。然后需要在 Google Workspace 管理控制台完成以下配置：

在 Google Cloud Console 中启用域范围授权
为服务账号添加必要的 OAuth 范围
在 Google Workspace 管理控制台中授权服务账号

2. 代码实现

以下是使用 Node.js 创建带参与者的日历事件的完整代码示例：

import { google } from 'googleapis';
import { JWT } from 'google-auth-library';

// 配置服务账号
const auth = new JWT({
  email: 'your-service-account-email@project-id.iam.gserviceaccount.com',
  key: '-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n',
  scopes: ['https://www.googleapis.com/auth/calendar'],
  subject: 'user@your-domain.com' // 要模拟的用户邮箱
});

const calendar = google.calendar({ version: 'v3', auth });

async function createEventWithAttendees() {
  try {
    const event = {
      summary: '项目会议',
      location: '线上会议',
      description: '讨论项目进度',
      start: {
        dateTime: '2024-08-22T09:00:00',
        timeZone: 'Asia/Tokyo',
      },
      end: {
        dateTime: '2024-08-22T10:00:00',
        timeZone: 'Asia/Tokyo',
      },
      attendees: [
        { email: 'attendee1@example.com' },
        { email: 'attendee2@example.com' }
      ],
      reminders: {
        useDefault: true,
      },
    };

    const response = await calendar.events.insert({
      calendarId: 'primary',
      resource: event,
      sendUpdates: 'all'
    });

    console.log('事件创建成功:', response.data.htmlLink);
  } catch (error) {
    console.error('创建事件失败:', error);
  }
}

createEventWithAttendees();