Что это
Microsoft Graph Calendar - часть Graph для работы с календарями Outlook. Приложение может получить события на день и подготовить список встреч. Создание и изменение событий - отдельные операции с другими требованиями к правам.
Для расписания используйте calendarView: он возвращает отдельные события, вхождения повторяющихся встреч и исключения внутри заданного периода. Это полезнее простого списка серий, когда нужны конкретные встречи на завтра. Даты и часовой пояс задавайте явно.
API не является помощником для планирования на базе AI. Модель может подготовить текст сводки по разрешенным событиям, но приглашения, переносы и отмены должен контролировать ваш процесс. Первый тест безопаснее провести на личных учебных событиях без участников.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- calendarView возвращает вхождения повторяющихся событий внутри выбранного окна.
- Можно ограничить запрос конкретным периодом вместо чтения всего календаря.
- Для базового чтения календаря предусмотрено отдельное разрешение Calendars.ReadBasic.
- Чтение и изменение событий можно разделить, начав интеграцию с получения расписания.
Ограничения
- Базовое разрешение не дает всех подробностей события: для расширенных данных нужны другие права.
- Ошибки часового пояса и границ периода могут исключить нужную встречу или показать лишнюю.
- Изменения с участниками могут отправить реальные приглашения или уведомления.
- Результат может быть постраничным; лимиты Graph и правила доступа организации остаются в силе.
Как использовать
1. Подготовка. В учебном календаре Outlook создайте два события без участников, одно можно сделать повторяющимся. Запишите их время и даты. Выберите день проверки и переведите его границы в UTC.
2. Настройка. Войдите учебным пользователем в Graph Explorer и запросите делегированное Calendars.ReadBasic. Для базового расписания не выдавайте права записи. Использование /me требует вошедшего пользователя.
3. Первый результат. Выполните GET https://graph.microsoft.com/v1.0/me/calendar/calendarView?startDateTime=2026-10-08T00:00:00Z&endDateTime=2026-10-09T00:00:00Z. Это пример суток UTC: замените обе даты своими границами. Получите названия и время событий; при наличии @odata.nextLink прочитайте следующие страницы.
4. Проверка. Сравните время в одном часовом поясе с Outlook и найдите нужное вхождение повторяющегося события. Проверьте события около границ дня. Запрос GET не должен менять календарь. Запись подключайте отдельно через подходящие права и подтверждение пользователя, сначала без реальных участников.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Нужны доступный календарь Outlook и разрешения соответствующей учетной записи. Право на чтение не означает право создавать встречи. Условия исходного сервиса и доступа организации проверяются отдельно.
Когда не подходит
- Разослать приглашения без проверки участников
- Считать даты без часового пояса локальным временем
- Поручить модели отмены и переносы без подтверждения
Альтернативы
Google Calendar API нужен для календарей Google. CalDAV - другой протокол для серверов, которые его поддерживают. Общий Microsoft Graph API объединяет календарь с другими ресурсами Microsoft; это не отдельная замена календарному endpoint.
