关于Google Calendar API时区参数替代UTC偏移量的技术问询

首先明确说：Google Calendar API完全支持直接使用标准IANA时区标识符（就是你列出的Europe/Prague、US/Eastern这类）来解析本地时间，不需要手动计算并附加UTC偏移量。你之前遇到的问题，核心是请求格式的错误——当你同时在dateTime字段里附加了UTC偏移，又设置了timeZone参数时，API会优先采用dateTime里的偏移值，直接忽略timeZone的设置。

正确的请求格式 #

你需要调整JSON结构，二选一即可：

方式1：本地时间 + IANA时区名称（推荐） #

把dateTime的值改成不带UTC偏移的本地时间，只保留timeZone字段设置为对应的时区标识符。比如针对你提供的示例，修正后应该是：

{
  "Event": {
    "description": "Out of office. Reason: Doctor_visit. Status: APPROVED.",
    "end": {
      "dateTime": "2016-11-16T09:00:00",
      "timeZone": "Europe/Prague"
    },
    "start": {
      "dateTime": "2016-11-16T12:00:00",
      "timeZone": "Europe/Prague"
    },
    "summary": "Out of office"
  },
  "parameters": {
    "calendarId": "xxx@group.calendar.google.com"
  }
}

这样API会自动根据Europe/Prague时区解析dateTime里的本地时间，转换成对应的UTC时间存储，同时在日历中显示为该时区的本地时间。

方式2：UTC时间 + 可选时区（用于显示） #

如果你更习惯传递UTC时间，可以在dateTime末尾加Z表示UTC，然后timeZone字段用来指定日历显示时使用的时区（不影响时间解析）：

{
  "Event": {
    "description": "Out of office. Reason: Doctor_visit. Status: APPROVED.",
    "end": {
      "dateTime": "2016-11-16T07:00:00Z",
      "timeZone": "Europe/Prague"
    },
    "start": {
      "dateTime": "2016-11-16T10:00:00Z",
      "timeZone": "Europe/Prague"
    },
    "summary": "Out of office"
  },
  "parameters": {
    "calendarId": "xxx@group.calendar.google.com"
  }
}

针对你之前尝试的错误说明 #

• 把偏移设为+0000再加时区名称：此时API会把dateTime当成UTC时间，timeZone仅用于显示，不是用来解析本地时间，所以达不到你想要的效果。
• 设置timeZone为UTC+2:00：Google Calendar API不接受这种偏移格式的时区值，只支持标准的IANA时区标识符（比如Europe/Prague）。

结合Dell Boomi的注意事项 #

• 检查日期时间格式：确保Boomi生成的dateTime值没有自动附加UTC偏移量——有些集成工具会默认把本地时间转成UTC并加偏移，你需要在Boomi的映射或数据处理步骤中，保留原始的本地时间字符串（不带偏移）。
• 验证时区标识符：你列出的时区列表里，像CET、PST这类是时区别名，Google虽然支持，但建议优先使用完整的IANA标识符（比如Europe/Prague代替CET），避免不同系统解析的歧义。
• 确认请求头：确保Boomi发送的请求头中Content-Type设置为application/json，否则API可能无法正确解析参数。

这样调整后，不管你的时区列表怎么扩充，只要传递标准的IANA时区名称，Google Calendar API都会自动处理时区转换，不需要你手动维护偏移量匹配表了。

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