Что возвращает CalendarEventEntry.getTimes () gdata-java-api?

Question

Я просматривал api-docs и не мог определить, когда и когда метод возвращает более одного When экземпляра. Код , кажется, анализирует повторяющиеся вхождения элементов <gd:when>, раздел общие элементы описания протокола имеет * после свойства gd:when, указывая, что несколько элементов этого типа. Но описание подразумевает, что существует только один элемент события.

Так в каком случае CalendarEventEntry.getTimes() возвращает более одного When экземпляра? Кажется возможным добавить несколько экземпляров через addTime(), но вы можете сделать это через веб-интерфейс по умолчанию?

Answer 1

Ответ можно найти в Руководство разработчика API данных: Протокол: раздел «Создание повторяющихся событий» :

---

• Нет параметров запроса: повторяющееся событие возвращается как отдельный элемент или объект с повторяющимся дочерним элементом или свойством. Нет, когда элементы или свойства включены в повторяющееся событие.
• указаны значения start-min и / или start-max: повторяющееся событие представляется как отдельный элемент или объект, с несколькими, когда элементы или объекты для каждого вхождения в указанном диапазоне . Повторение также включено.
• singleevents = true: повторяющиеся события представляются в том же формате, что и отдельные события, с одним элементом или объектом в каждом случае возникновения события. Каждое событие включает отдельный элемент when или объект, но не включает синтаксис повторения. Однако оно включает элемент или свойство originalEvent.