google calendar api:calendars vs calendarList

Question

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

Answer 1

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

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

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

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