Google Calendar API事件列表顺序异常：取消项先于重复父事件返回

调用Google Calendar API获取事件列表时，会出现不符合逻辑的异常：重复序列中已取消的子事件，会排在它所属的重复父事件前面（相当于子项先于父项存在）。

API返回的示例数据如下：

[
  {
    "kind": "calendar#event",
    "etag": "\"3351534257460000\"",
    "id": "3cuva67b29fet1joar70n1vvf4_20230301T084500Z",
    "status": "cancelled",
    "recurringEventId": "3cuva67b29fet1joar70n1vvf4_R20230208T084500",
    "originalStartTime": {
      "dateTime": "2023-03-01T10:45:00+02:00",
      "timeZone": "Asia/Jerusalem"
    }
  },
  {
    "kind": "calendar#event",
    "etag": "\"3351534257460000\"",
    "id": "3cuva67b29fet1joar70n1vvf4_R20230208T084500",
    "status": "confirmed",
    "htmlLink": "https://www.google.com/calendar/event?private",
    "created": "2021-11-28T11:55:13.000Z",
    "updated": "2023-02-07T10:52:08.757Z",
    "summary": "private",
    "creator": {
      "email": "private@gmail.com"
    },
    "organizer": {
      "email": "private.calendar.google.com",
      "displayName": "private",
      "self": true
    },
    "start": {
      "dateTime": "2023-02-08T10:45:00+02:00",
      "timeZone": "Asia/Jerusalem"
    },
    "end": {
      "dateTime": "2023-02-08T11:35:00+02:00",
      "timeZone": "Asia/Jerusalem"
    },
    "recurrence": [
      "RRULE:FREQ=WEEKLY"
    ],
    "iCalUID": "private@google.com",
    "sequence": 1,
    "reminders": {
      "useDefault": false
    },
    "eventType": "default"
  }
]

解决办法 #

Google Calendar API的默认返回顺序不保证父事件一定排在子事件之前，需要通过本地处理或调整API参数来修正：

1. 本地排序修正顺序

获取到事件列表后，自定义排序逻辑，确保父事件优先排在前面。可以通过两个特征判断父事件：

• 包含recurrence字段（定义了重复规则）
• 没有recurringEventId字段（不是某个重复事件的实例）

示例JavaScript排序代码：

events.sort((a, b) => {
  // 判断是否为父事件
  const isParentA = !!a.recurrence || !a.recurringEventId;
  const isParentB = !!b.recurrence || !b.recurringEventId;

  if (isParentA && !isParentB) return -1; // 父事件排前面
  if (!isParentA && isParentB) return 1; // 子事件排后面
  // 同类型事件按更新时间倒序排序
  return new Date(b.updated) - new Date(a.updated);
});

2. 调整API请求参数

• 尝试使用orderBy参数，比如按updated或start排序，部分场景下能让父事件优先返回：

  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events?orderBy=updated
  

• 如果业务允许，使用singleEvents=true参数展开所有重复事件，此时每个事件都是独立实例，便于统一处理顺序，但会增加返回数据量。

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