Календари

Элементы группы Office 365 → Календари предназначены для работы с календарями Outlook в Microsoft 365: получения календарей, создания, поиска, изменения и удаления событий, приглашения участников, ответа на приглашения и подбора времени встречи. Все элементы размещаются внутри контейнера Microsoft 365.

• Получить календари — получение списка календарей и календаря по умолчанию.
• Создать событие — создание события в календаре.
• Поиск событий — поиск событий за период и по тексту.
• Изменить событие — изменение темы, времени и других параметров события.
• Добавить участника — приглашение участника на событие.
• Добавить локацию — добавление места проведения.
• Добавить вложение — прикрепление файла к событию.
• RSVP — ответ на приглашение: принять, под вопросом, отклонить.
• Удалить событие — удаление события.
• Найти интервалы встреч — подбор свободного времени для встречи нескольких участников.

Необходимые разрешения Microsoft Graph: Calendars.ReadWrite. Подробнее — в разделе Настройка доступа к Microsoft 365.

Свойство E-Mail

Свойство E-Mail определяет, с календарями какого пользователя работает элемент. Если не заполнено — пользователя, под которым выполнен вход (только при типе аутентификации UsernameAndPassword). При входе по сертификату или секрету заполнение обязательно. См. Учетная запись в элементах.

Событие, найденное или созданное в календаре одного пользователя, обрабатывается последующими элементами с тем же значением E-Mail.

Часовой пояс

Время начала и окончания событий задается значениями типа DateTime в часовом поясе, указанном в свойстве Часовой пояс. Поддерживаются имена часовых поясов Windows и IANA:

Важно: Если свойство Часовой пояс не заполнено, время интерпретируется в поясе "Pacific Standard Time" (UTC−8). Всегда указывайте часовой пояс явно.

Примечание: Часовой пояс времени в объекте события указан в свойстве evt.Start.TimeZone. У событий, возвращенных элементом Поиск событий, время указано в UTC — для перевода в местное время: DateTime.SpecifyKind(DateTime.Parse(evt.Start.DateTime), DateTimeKind.Utc).ToLocalTime(). У события, возвращенного элементом Создать событие, время указано в часовом поясе из свойства Часовой пояс.

Свойства события

Элементы группы возвращают и принимают события в виде объектов Microsoft.Graph.Models.Event: