gdata-java-api的CalendarEventEntry.getTimes（）返回什么？

Question

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

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

Answer 1

答案可以在Data API Developer's Guide: The Protocol: Section "Creating Recurring Events"中找到：

---

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