Google Calendar API创建Hangouts Meet会议失败问题排查

核心原因：请求体遗漏关键配置+URL缺少版本参数 #

创建带Meet链接的日历事件，必须同时满足两个核心条件，缺一不可：

1. 请求体必须包含conferenceData配置段 #

这是触发Google Meet会议生成的核心字段，缺少它只会创建普通日历事件，自然不会返回任何会议相关信息。正确的配置结构如下：

"conferenceData": {
  "createRequest": {
    "conferenceSolutionKey": {
      "type": "hangoutsMeet"
    },
    "requestId": "唯一随机字符串（比如UUID或自定义的唯一标识）"
  }
}

• requestId是必填项：用于防止重复创建会议，只要是唯一的字符串即可，比如随手生成的一串字母数字组合。
• type固定为hangoutsMeet：明确告知API要生成Google Meet类型的会议链接。

2. 请求URL必须携带conferenceDataVersion=1参数 #

即使请求体配置正确，URL里没加这个参数，API也不会返回会议链接信息。完整请求URL示例：

https://www.googleapis.com/calendar/v3/calendars/primary/events?conferenceDataVersion=1

完整的cURL请求示例 #

curl -X POST \
  'https://www.googleapis.com/calendar/v3/calendars/primary/events?conferenceDataVersion=1' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "summary": "团队同步会议",
  "start": {
    "dateTime": "2024-06-15T10:00:00+08:00",
    "timeZone": "Asia/Shanghai"
  },
  "end": {
    "dateTime": "2024-06-15T11:00:00+08:00",
    "timeZone": "Asia/Shanghai"
  },
  "conferenceData": {
    "createRequest": {
      "conferenceSolutionKey": {
        "type": "hangoutsMeet"
      },
      "requestId": "abc123xyz789"
    }
  }
}'

验证结果 #

调整后重新发起请求，响应体中会出现conferenceData字段，包含Meet的入会链接、会议ID等完整会议信息。

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