google calendar api:calendars vs calendarList

时间:2014-10-23 20:25:10

标签: google-api google-calendar-api

我正在努力添加一个新的日历,我花了很长时间才发现我必须将它添加到日历'日历中。而不是' CalendarList'。它现在有效,这很好,但我这两个概念有什么区别?在我看来,我只需要日历?此外,CalendarList似乎无法正常工作,尝试插入日历时返回404错误。

2 个答案:

答案 0 :(得分:19)

日历是世界上所有日历的集合(它没有列表方法)。创建新日历时,应在日历集合上调用插入。当您需要特定于日历的数据(例如时区,名称)时,您应该使用get从日历集合中检索日历。

CalendarLists是用户添加到其列表中的所有日历条目的集合(在Web UI中,它是左侧面板中的日历列表)。您无法通过日历列表集合创建新日历,但可以将现有日历添加到用户日历列表中。例如,每个用户可以为同一日历使用不同的颜色,并且此详细信息将存储在日历列表条目中。

有时令人困惑的是,当您通过日历集合创建新日历时,它会自动添加到您的列表中。

让我举一个Calendars和CalendarLists如何工作的例子。想象一下,你的朋友为你将要一起旅行的旅行创建一个日历。他通过执行Calendars.insert()调用来完成此操作。 现在他将日历公开(通过ACL集合)并向您和所有朋友发送此日历的电子邮件。您可以进入CalendarLists集合并在那里进行insert()调用,将其添加到日历列表中并使其变为蓝色。

答案 1 :(得分:0)

日历:

  

Calendars集合代表所有现有日历。有可能   用于创建和删除日历。您也可以检索或设置   所有可以访问日历的用户共享的全局属性。   例如,日历的标题和默认时区是全局的   属性。

CalendarList:

  

CalendarList是用户的所有日历条目的集合   已添加到其列表中(显示在Web UI的左侧面板中)。您   可以使用它来添加和删除用户的现有日历   名单。您还可以使用它来检索和设置特定于用户的值   日历属性,例如默认提醒。另一个例子是   前景色,因为不同的用户可以设置不同的颜色   对于同一日历。

这里比较表: https://developers.google.com/google-apps/calendar/concepts/events-calendars