Коннектор календаря Microsoft
- 06 Mar 2024
- 5 Минуты для чтения
- Авторы
- Распечатать
Коннектор календаря Microsoft
- Обновление 06 Mar 2024
- 5 Минуты для чтения
- Авторы
- Распечатать
Article Summary
Share feedback
Thanks for sharing your feedback!
::: (информация) () Чтобы скачать приложение, посетите: Библиотека:::
Интеграция с графическим API Microsoft для календаря
Введение
Microsoft Calendar API позволяет пользователям создавать, читать и редактировать события календаря Microsoft с соответствующим доступом, установленным для их учетных записей M365. Цель этого коннектора - интегрировать Tulip с Microsoft с помощью Microsoft Graph API (v1.0), используя HTTP-коннекторы, и предоставить нашим клиентам готовый коннектор, который можно импортировать в их экземпляр.
Назначение
Мы собираемся осветить различные функции коннектора, которые могут быть построены путем выполнения HTTP-вызовов к Microsoft's Graph Api(v1.0) для взаимодействия с событиями календаря Microsoft, чтобы продемонстрировать различные действия чтения и записи в календаре, которые могут быть использованы для различных случаев использования.
Документация API
Документация Microsoft Graph API
Предварительные требования
- Создайте учетную запись на Microsoft 365 и настройте учетные данные OAuth 2.0 в Microsoft Entra ID.
- Зарегистрируйте API с необходимыми диапазонами на портале Microsoft. Azure - Entra ID
Видео о настройке коннектора для excel:
Вы можете выполнить те же шаги для настройки коннектора календаря.
Детали подключения Tulip
Следующую информацию необходимо настроить в Tulip's
Коннекторы.
- Работает на: хосте облачного коннектора
- Хост: graph.microsoft.com
- Порт:443
- TLS: Да
OAuth 2: аутентификация будет передана всем функциям коннектора
Функции коннектора
1) Получить все события календаря
Назначение
Этот коннектор будет получать все события календаря из календаря M365.
Конечная точка
HTTP GET вызов конечной точки: https://graph.micrsoft.com:443/v1.0/me/events.
Требуемый ввод
Входы не требуются
Выходной экстрактор
- eventID: Уникальный идентификатор события, который будет использоваться для выполнения других задач.
- eventSubject: Субъект события.
- eventContent: Содержание события.
- eventStartDate: Дата и время начала события.
- eventEndDate: Дата и время окончания события.
- eventLocation: Место проведения мероприятия.
- eventAttendees: Участники мероприятия.
- eventOrganizer: Организатор мероприятия.
- Дополнительные параметры, возвращаемые вместе с ответом, включаются в состав выходных параметров.
2) Получить расписание собраний пользователей
Назначение
Этот коннектор позволяет получить информацию о наличии свободных/занятых мест для набора пользователей, списков распределения или ресурсов (комнат или оборудования) на указанный период времени.
Конечная точка
HTTP GET вызов конечной точки -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule
Требуемый ввод
Ниже перечислены параметры, которые должны быть переданы в теле запроса
- Адрес электронной почты: Набор SMTP-адресов пользователей, списков рассылки или ресурсов, для которых необходимо получить информацию о доступности.
- Schedule Start Date Time: дата, время и часовой пояс начала периода.
- Schedule End Date Time: Дата, время и часовой пояс окончания периода.
- Часовой пояс: Временная зона события.
Экстрактор выходных данных
- scheduleUserId: Адрес электронной почты пользователя расписания.
- startTime: дата, время и часовой пояс начала периода.
- endTime: Дата, время и часовой пояс окончания периода.
- timeZone: часовой пояс.
- scheduleStatus: Статус ответа на расписание пользователя.
- scheduleSubject: Тема запланированного события.
- scheduleLocation: Местонахождение запланированного события.
- scheduleStartDateTime: Время начала даты запланированного события.
- scheduleEndDateTime: время окончания запланированного события.
3) Создать событие
Назначение
- Пользователи могут передать в качестве входных данных тему события, содержание, время начала, время окончания и другие параметры, и Tulip создаст новое событие календаря с учетом предоставленных данных. Ответом API будут метаданные и различные свойства календарного события. В дальнейшем это можно использовать для получения и обновления событий.
- Этот коннектор может создать событие в календаре пользователя по умолчанию или в указанном календаре для конкретного пользователя, группы пользователей или нескольких пользователей.
- Информация, полученная из Microsoft Graph V1.0 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора.
Конечная точка
HTTP POST вызов конечной точки: https://graph.microsoft.com:443/v1.0/me/events.
Требуемый ввод
Ниже перечислены параметры, которые должны быть переданы в теле запроса
- Субъект события: Тема события
- Содержание события: Содержание события
- Event Start Date Time: Время начала события
- Event Timezone: Часовой пояс события
- Event End Date Time: Время окончания события
- Место события: Место проведения мероприятия
- Attendee Email Address: Адрес электронной почты участника
Экстрактор выходных данных
- eventId: Идентификатор созданного события
- eventTimezone: Временная зона события
- eventSubject: Тема события
- eventBody: Содержание события
- eventStartDateTime: Время начальной даты события
- eventEndDateTime: Время окончания события
- eventLocation: Местоположение события
- Дополнительные параметры, возвращаемые вместе с ответом, включаются в состав выходных параметров.
4) Создание повторяющихся событий
Назначение
- Пользователи могут передать тему события, содержание, время начала, время окончания и другие параметры в качестве входных данных, и Tulip создаст новое повторяющееся событие календаря с предоставленными входными данными. Ответом API будут метаданные и различные свойства календарного события. В дальнейшем это можно использовать для получения и обновления событий.
- Этот коннектор создаст повторяющееся событие в календаре пользователя по умолчанию и в указанном календаре для пользователя или группы пользователей.
- Информация, полученная из Microsoft Graph V1.0 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора.
Конечная точка
HTTP POST вызов конечной точки https://graph.microsoft.com:443/v1.0/me/events.
Требуемый ввод
Ниже перечислены параметры, которые должны быть переданы в теле запроса
- Субъект события: Тема события
- Содержание события: Содержание события
- Event Start Date Time: Время начала события
- Event Timezone: Часовой пояс события
- Event End Date Time: Время окончания события
- Место события: Место проведения мероприятия
- Attendee Email Address: Адрес электронной почты участника
- Тип повторяющегося события: Тип повторяющегося события
- Дни недели повторения: День события повторения
- Recurrence Start Date: Дата начала события повторения
- Recurrence End Date: Дата окончания события повторения
Экстрактор выходных данных
- eventId: Идентификатор созданного события
- eventTimezone: Временная зона события
- eventSubject: Тема события
- eventBody: Содержание события
- eventStartDateTime: Время начальной даты события
- eventEndDateTime: Время окончания события
- eventLocation: Местоположение события
- eventRecurrenceRangeStartDate: Дата начала события рекурренции.
- eventRecurrenceRangeEndDate: Дата окончания рекуррентного события.
- eventAttendees: Участники события.
- eventOrganizer: Организатор события.
- Дополнительные параметры, возвращаемые вместе с ответом, включаются в состав выходных параметров.
5) Обновление события
Назначение
- Пользователи могут передать ID события, тему, содержание и другие параметры в качестве входных данных, и Tulip обновит события в календаре. Ответом API будут метаданные и различные свойства событий календаря.
- Информация, полученная из Microsoft Graph V1.0 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора.
Конечная точка
HTTP PATCH-вызов конечной точки https://graph.microsoft.com:443/v1.0/me/events/{eventID}.
Необходимые входные данные
Ниже перечислены параметры, которые передаются в теле запроса
- Субъект события: Тема события
- Содержание события: Содержание события
- Event Start Date Time: Время начала события
- Event TimeZone: Временная зона события
- Event End Date Time: Время окончания события
- Event Location: Место проведения мероприятия
- Attendee Email Address: Адрес электронной почты участника
Экстрактор выходных данных
- eventId: Идентификатор созданного события
- eventTimezone: Временная зона события
- eventSubject: Тема события
- eventBody: Содержание события
- eventStartDateTime: Время начальной даты события
- eventEndDateTime: Время окончания события
- eventLocation: Местоположение события
- Дополнительные параметры, возвращаемые вместе с ответом, включаются в состав выходных параметров.
6) Удалить событие
Назначение
- Пользователи могут передать идентификатор события в качестве входных данных, и Tulip удалит событие в календаре.
Конечная точка
HTTP DELETE вызов конечной точки - https://graph.microsoft.com:443/v1.0/me/events/{eventID}
Необходимые входные данные
Ниже перечислены параметры, которые передаются в теле запроса
- Идентификатор события - идентификатор события
Дополнительное чтение
Ознакомьтесь с дополнительной информацией о коннекторах Microsoft
Была ли эта статья полезной?
