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