我正在尝试添加新日历，我花了很长时间才弄清楚我必须将其添加到“日历”而不是“日历列表”。现在它可以工作了，这很好，但是这两个概念有什么区别？在我看来我只需要日历？另外，CalendarList 似乎不起作用，尝试插入日历返回了 404 错误。
Calendars 是世界上所有日历的集合（它没有列表方法）。创建新日历时，您应该调用日历集合上的插入。当您需要日历特定数据（例如时区、名称）时，您应该使用 get 从日历集合中检索日历。
CalendarLists 是用户添加到列表中的所有日历条目的集合（在 Web UI 中，它是左侧面板中的日历列表）。您无法通过日历列表集合创建新日历，但可以将现有日历添加到用户日历列表中。例如，每个用户可以对同一日历使用不同的颜色，并且此详细信息将存储在日历列表条目中。
有时令人困惑的是，当您通过日历集合创建新日历时，它将自动添加到您的列表中。
让我举一个例子来说明日历和日历列表的工作原理。想象一下，您的朋友为你们将一起进行的旅行创建了一个日历。他通过调用 Calendars.insert() 来完成此操作。 现在，他将日历公开（通过 ACL 集合）并向您和所有朋友发送此日历的电子邮件。您可以进入 CalendarLists 集合并在那里执行 insert() 调用，将其添加到您的日历列表中并将其设置为蓝色。
日历：
Calendars 集合代表所有现有的日历。有可能 用于创建和删除日历。您还可以检索或设置 全局属性在所有有权访问日历的用户之间共享。 例如，日历的标题和默认时区是全局的 属性。
日历列表：
CalendarList 是用户查看的所有日历条目的集合 已添加到其列表中（显示在 Web UI 的左侧面板中）。你 可以使用它向用户的日历添加或删除现有的日历 列表。您还可以使用它来检索和设置特定于用户的值 日历属性，例如默认提醒。另一个例子是 前景色，因为不同的用户可以设置不同的颜色 相同的日历。
对比表如下： https://developers.google.com/calendar/api/concepts/events-calendars#calendar_list