获取邮箱账号域范围委派权限，解决Google Calendar API 403错误

错误核心原因 #

这个403错误的本质是：服务账号本身没有邀请参会者的权限，必须通过域范围委派权限模拟域内用户身份，才能执行带参会者的日历事件操作。

可行解决方案 #

1. 配置域范围委派权限（需域管理员操作） #

• 登录Google Admin控制台，找到服务账号所属的项目，进入服务账号详情页，开启「域范围委派」选项
• 转到Admin控制台的「安全」→「API控制」→「域范围委派」，添加服务账号的客户端ID，并授予至少一个满足需求的Calendar API权限：
  • https://www.googleapis.com/auth/calendar：全权限，适合需要完整日历操作的场景
  • https://www.googleapis.com/auth/calendar.events：仅事件操作权限，适合只处理事件的场景

2. 修改代码，正确模拟域内用户身份 #

服务账号不能直接发起带参会者的请求，必须模拟域内的有效用户（比如你的业务邮箱）。修改认证代码示例如下：

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

// 初始化JWT认证，添加subject参数指定要模拟的域内用户邮箱
const auth = new google.auth.JWT(
  process.env.GOOGLE_SERVICE_ACCOUNT_EMAIL, // 服务账号邮箱
  null,
  process.env.GOOGLE_PRIVATE_KEY.replace(/\\n/g, '\n'), // 服务账号私钥
  ['https://www.googleapis.com/auth/calendar'], // 权限范围
  'user@your-domain.com' // 替换为你要模拟的域内用户邮箱
);

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

// 创建带参会者和Meet会议的事件示例
async function createCalendarEvent() {
  const eventData = {
    summary: '项目同步会议',
    description: '通过Google Meet开展的项目同步会',
    start: {
      dateTime: '2024-05-20T14:00:00+08:00',
      timeZone: 'Asia/Shanghai',
    },
    end: {
      dateTime: '2024-05-20T15:00:00+08:00',
      timeZone: 'Asia/Shanghai',
    },
    attendees: [
      { email: 'team-member1@your-domain.com' },
      { email: 'team-member2@your-domain.com' },
    ],
    conferenceData: {
      createRequest: {
        requestId: 'unique-request-id-456',
        conferenceSolutionKey: { type: 'hangoutsMeet' },
      },
    },
  };

  try {
    const result = await calendar.events.insert({
      calendarId: 'primary',
      resource: eventData,
      conferenceDataVersion: 1,
      sendUpdates: 'all',
    });
    console.log('事件创建成功:', result.data.htmlLink);
  } catch (err) {
    console.error('创建事件失败:', err);
  }
}

createCalendarEvent();

3. 确认Calendar API已启用 #

登录Google Cloud控制台，找到对应项目，搜索「Calendar API」，确保状态为「已启用」，未启用的话点击「启用」激活即可。

4. 等待权限同步并验证 #

配置完成后，等待10-15分钟让权限同步，再重新运行代码测试。如果仍报错，检查服务账号邮箱、私钥、模拟用户邮箱是否正确，以及权限范围是否覆盖了所需操作。

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