Google Calendar API导入/修改recurring event致参会者意外添事件求助

现象解释 #

• 使用events.import接口时，若请求体包含attendees且设置responseStatus: accepted，API会默认以组织者身份替参会者确认邀请，自动将事件添加到参会者日历。这是因为import接口的设计初衷是模拟导入完整的会议邀约数据，包含参会者接受状态时会触发邀请同步逻辑。
• 对于重复事件（recurring event），其所有实例与原系列事件共享参会者关联关系。即使修改单个实例时未在请求体中提及参会者，API仍会默认同步更新所有关联参会者的日历，因为实例属于系列事件的一部分，继承了系列的参会者绑定规则。

修正方案 #

一、导入事件时仅保留在组织者日历 #

方案1：移除参会者字段（推荐）

直接删除请求体中的attendees数组，事件将仅创建在组织者test.user1@mydomain.com的日历中，不会涉及任何参会者同步：

{
  "summary": "Test Meeting",
  "organizer":  {
    "email": "test.user1@mydomain.com",
    "displayName": "test.user1@mydomain.com",
    "self": true
  },
  "iCalUID": "65e1ebe033c1cfdde029312745195c8b-30746",
  "start": {
    "dateTime": "2024-10-07T10:30:00-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "end": {
    "dateTime": "2024-10-07T11:30:00-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "recurrence": [ "RRULE:FREQ=WEEKLY;INTERVAL=1;BYDAY=MO" ],
  "reminders": {
    "useDefault": false,
    "overrides": [ { "method": "popup", "minutes": 10 } ]
  },
  "visibility": "default"
}

方案2：保留参会者但禁用同步

如果必须保留参会者信息但不想同步到他们的日历，需做两处修改：

1. 将参会者的responseStatus改为needsAction（避免替参会者确认邀请）；
2. 在API请求URL中添加sendUpdates=none参数，阻止发送邀请通知：

https://www.googleapis.com/calendar/v3/calendars/test.user1@mydomain.com/events/import?quotaUser=test.user1@mydomain.com&supportsAttachments=True&access_token=ya29.a0AcM612zVZS40w...&sendUpdates=none

修改后的参会者字段示例：

"attendees": [
  {
    "email": "test.user2@mydomain.com",
    "resource": false,
    "optional": false,
    "responseStatus": "needsAction"
  },
  {
    "email": "test.user1@mydomain.com",
    "resource": false,
    "optional": false,
    "responseStatus": "accepted"
  }
]

方案3：改用events.insert接口

events.import专为导入外部iCal设计，自带邀约同步逻辑；而events.insert更适合创建仅属于当前日历的事件。使用该接口时，即使添加参会者，配合sendUpdates=none参数即可避免同步到参会者日历：

https://www.googleapis.com/calendar/v3/calendars/test.user1@mydomain.com/events?quotaUser=test.user1@mydomain.com&supportsAttachments=True&access_token=ya29.a0AcM612zVZS40w...&sendUpdates=none

二、修改重复事件实例时避免同步至参会者日历 #

1. 在修改实例的API请求URL中添加sendUpdates=none参数，阻止API向参会者发送更新通知；
2. 若希望实例完全脱离原系列的参会者关联，可在请求体中显式清空attendees数组：

{
  // 其他修改字段（如时间、标题等）
  "attendees": []
}

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