使用NodeJS调用Google Calendar API创建事件时提示“Missing end time”错误求助

我之前在NodeJS里调用Google Calendar API创建事件时也踩过这个一模一样的坑！能成功获取事件列表，说明你的授权和API客户端配置都没问题，问题大概率出在事件对象的格式细节上，咱们一步步排查：

• 检查end字段的嵌套结构
  Google Calendar API要求start和end都必须是包含dateTime/date的对象，不能直接传字符串。很多人容易犯这个低级错误：

  // ❌ 错误写法：end直接传字符串
  const badEvent = {
    summary: "团队同步会",
    start: { dateTime: "2024-05-20T09:00:00", timeZone: "Asia/Shanghai" },
    end: "2024-05-20T10:00:00"
  };
  

  改成正确的嵌套结构就能解决一半问题：

  // ✅ 正确写法：end是包含dateTime和timeZone的对象
  const goodEvent = {
    summary: "团队同步会",
    start: {
      dateTime: "2024-05-20T09:00:00",
      timeZone: "Asia/Shanghai"
    },
    end: {
      dateTime: "2024-05-20T10:00:00",
      timeZone: "Asia/Shanghai"
    }
  };
  

• 全天事件的特殊规则
  如果是创建全天事件，要用date字段而非dateTime，而且end的date必须比start晚一天（因为Google的全天事件是左闭右开区间）：

  // ✅ 正确的全天事件写法
  const allDayEvent = {
    summary: "公司年会",
    start: { date: "2024-06-01" },
    end: { date: "2024-06-02" } // 注意这里是第二天，不是当天
  };
  

  要是把end写成和start一样的日期，API会判定为end时间无效，直接触发"Missing end time"错误。

• 确认时区是否正确指定
  只传dateTime不传timeZone也可能导致API解析失败，建议始终明确指定时区（比如"UTC"或"Asia/Shanghai"），避免因时区偏移导致的时间格式识别错误。

• 检查API调用的参数位置
  用NodeJS客户端调用calendar.events.insert时，事件对象必须放在resource字段里，别传错位置：

  // ✅ 正确的调用方式
  calendar.events.insert(
    {
      calendarId: "primary", // 你的日历ID，primary代表默认日历
      resource: goodEvent // 事件对象必须放在resource字段下
    },
    (err, response) => {
      if (err) {
        console.error("创建事件失败:", err);
        return;
      }
      console.log("事件创建成功:", response.data);
    }
  );
  

如果还是有问题，建议用Google的API在线调试工具先测试你的事件结构，能快速定位是不是参数格式的问题。

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