gdata-java-api 的 CalendarEventEntry.getTimes() 返回什么？

Question

我一直在查找 api-docs，但无法确定该方法是否以及何时返回多个 When 实例。 code 似乎解析了重复出现的<gd:when> 元素，协议描述的common elements 部分在gd:when 属性之后有一个*，表明可以有多个这种类型的元素。但描述暗示只有一个事件元素。

那么在哪种情况下CalendarEventEntry.getTimes() 会返回多个When 实例？好像可以通过addTime()添加多个实例，但是可以通过默认的网页界面来实现吗？

Answer 1

答案在Data API Developer's Guide: The Protocol: Section "Creating Recurring Events"：

---

• 无查询参数：重复事件作为单个元素或对象返回，并带有重复的子元素或属性。当重复事件中包含元素或属性时，否。
• 指定了 start-min 和/或 start-max：重复事件表示为单个元素或对象，在指定范围内每次出现时都有多个 when 元素或对象。还包括重复。
• singleevents=true：重复事件以与单个事件相同的格式表示，每次事件出现一个元素或对象。 每个事件都包含一个 when 元素或对象，但不包含重复语法。 但是，它包含一个 originalEvent 元素或属性。