Общие сведения об API календарей Outlook

  • Статья

Календарь Outlook входит в состав центра обмена сообщениями Outlook в Microsoft 365. С его помощью можно управлять электронными письмами и контактами, искать информацию о пользователях в организации, инициировать беседы через Интернет, делиться файлами и совместно работать в группах.

Зачем выполнять интеграцию с Календарем Outlook?

Широкий набор функций календаря Outlook и его API открывает множество возможностей приложений. В следующих разделах перечислены некоторые из них.

Доступ к сотням миллионов клиентов и создание функциональных сценариев

Многие миллионы клиентов используют Календарь Outlook в составе интегрированного центра, с помощью которого они эффективно общаются и работают. Они могут настраивать собрания, управлять электронными письмами, находить информацию о контактах и других пользователях, а также инициировать беседы или собрания в Интернете в одном месте независимо от используемых устройств: в Интернете, на мобильных или настольных устройствах. Microsoft Graph не только подключает приложения к данным Календаря, Почты и Контактов этих клиентов. Он дает возможность интегрировать приложения с лучшими средствами Microsoft 365 и поддерживает широкий спектр сценариев, повышающих производительность труда и расширяющих возможности совместной работы.

Большинство функций API календаря Outlook применяются к календарям в личных учетных записях Майкрософт, а также в рабочих или учебных учетных записях.

** Обозначает указанные ниже функции, применяемые к календарям Outlook только в рабочих или учебных учетных записях.

Автоматизация упорядочивания встреч и ведения календаря

Клиентам нравится то, как Outlook помогает упорядочить время, которое они тратят на работу, семью и личные дела. REST API для Microsoft Graph обеспечивает удобство для пользователей, позволяя естественным путем создавать мероприятия, управлять ими и реагировать на них в приложениях.

  • В Outlook клиенты могут создавать отдельные календари для работы, семьи и других целей, а также упорядочивать их в группах календарей. Они могут включать бесплатные календари дней рождения и праздников, которые напоминают о днях рождения контактов и местных праздниках. Они могут добавлять календари согласно своим интересам, например календари спортивных команд и телепередач. Клиенты могут выбирать календари, накладывать их друг на друга и отображать все мероприятия в одном представлении. С помощью API календаря приложение может так же упорядочивать календари в группах календарей и взаимодействовать с интересными календарями, как и любой другой календарь в почтовом ящике пользователя.

  • Клиенты Outlook могут единообразно применять категории к мероприятиям, сообщениям, контактам и записям в группах, чтобы упорядочить эти элементы и упростить их поиск. С помощью API Календаря вы можете получать доступ к основному списку категорий пользователя и задавать его, и это позволяет использовать дополнительные творческие сценарии. Например, спортивный клуб может организовать спортивные соревнования и предложить приложение, которое помечает электронные письма и мероприятия для каждого вида спорта отдельной цветовой категорией. Кроме того, для последних новостей, например для непросмотренных изменений в расписании, приложение может задавать свойство важности для мероприятий и электронных писем, чтобы предупреждать клиентов о них.

  • В папке календаря вы можете создавать и изменять одиночные мероприятия или планировать и поддерживать повторяющиеся мероприятия. Вы можете разрешить клиентам отвечать на приглашения на собрания, а также отложить или закрытьнапоминания с помощью связанного свойства навигации по событиям .

Помогите клиентам поддерживать синхронизацию и ориентироваться в рабочем дне

API Календаря помогает клиентам ориентироваться в их рабочем дне и повышать эффективность работы.

Расширение возможностей совместной работы

  • В Outlook клиенты могут делиться друг с другом календарями и предоставлять разрешения на чтение, запись или удаление контента календарей. Кроме того, они могут делегировать календарь, чтобы разрешить другому клиенту отвечать на приглашения на собрания от их лица. В данный момент (пока нет возможности программным путем инициировать общий доступ или делегировать действие от имени пользователя) вы можете проверять состояние общего доступа и использовать различные сценарии, связанные с общими или делегированными календарями, с помощью следующего набора свойств: canEdit, canShare, canViewPrivateItems, isShared и isSharedWithMe.
  • API Календаря позволяет получать элементы календаря пользователя, вошедшего в систему, или пользователей, которые поделились своими календарями либо делегировали их пользователю, вошедшему в систему. Например, если Григорий поделился календарем с Артемом или делегировал доступ к нему, то делегированные разрешения от Артема предоставят вам доступ на чтение календаря и контента, которыми поделился Григорий.
  • Группы Microsoft 365 упрощают участникам групп совместную работу и доступ к групповым чатам и календарям непосредственно в Outlook. Если не учитывать несколько незначительных отличий между календарями групп и календарями пользователей, API Календаря дает возможность взаимодействовать с календарями групп так же, как с календарями пользователей. Дополнительные сведения см. в описании ресурса calendar**.

Интеллектуальное планирование

Outlook и API Календаря предоставляют множество интеллектуальных удобств при планировании мероприятий.

  • В параметрах приложения Календаря Outlook клиенты могут включить функцию автоматического добавления мероприятий из электронных писем, например сведений о рейсах, гостиницах или резервировании столиков в кафе и выставления счетов. После добавления мероприятий вы можете взаимодействовать с ними как и с любыми другими объектами event в почтовом ящике пользователя, а также создавать творческие сценарии на основе этой возможности Outlook.
  • В Outlook зарезервировать комнату для собрания так же просто, как добавить участника в мероприятие. API Календаря представляет комнату для собраний в качестве объекта emailAddress. Вы можете получать комнаты и списки комнат, доступные в клиенте. Чтобы организовать собрание в определенной комнате, назначьте ее свойству location объекта event.**
  • Вы можете искать информацию о доступности для пользователей и ресурсов для определенного периода времени. Затем эти данные можно использовать, чтобы применить к различным сценариям, включая планирование ресурсов и планирование событий.**
  • Если ваш сценарий включает планирование встреч в оптимальное время, вы можете использовать findMeetingTimes для определения возможного времени и места для встречи. Функция findMeetingTimes проверяет состояние "свободен" или "занят" участников собрания, а также предпочтительные помещения, время и другие указанные вами ограничения. Если с первой попытки не удается получить стандартное время собрания, выясните причину этого, скорректируйте критерии и вызовите функцию findMeetingTimes еще раз.**

Телеконференции в нескольких расположениях и часовых поясах

С ростом глобализации в современных бизнес-собраниях часто задействованы участники из различных расположений и часовых поясов. Ниже рассказывается, как с помощью API Календаря управлять такими собраниями.

  • Например, в Outlook клиенты могут организовать собрание и добавить в него участников, присоединяющихся к собранию в переговорной в Москве, кафе в Париже и в домашнем офисе в Китае. Программным путем свойство locations мероприятия, представляющее собой коллекцию объектов location, может отражать этот уровень сведений в свойствах displayName и locationType для каждого объекта location. См. пример.
  • В Outlook имеются гибкие возможности, с помощью которых пользователи могут упорядочивать мероприятия и указывать часовые пояса для времени начала и окончания мероприятия. Для поддержки таких возможностей по умолчанию API Календаря возвращает время начала и окончаниямероприятия в формате UTC и указывает часовые пояса, выбранные при создании мероприятия, в свойствах originalStartTimeZone и originalEndTimeZone.
  • Кроме того, вы можете указать заголовок Prefer: outlook.timezone="{time zone name}", чтобы операция GET для мероприятия возвратила время начала и окончания в указанном вами часовом поясе. Вы можете использовать любые названия часовых поясов, поддерживаемые в Windows, а также названия из этого списка. См. пример использования заголовка Prefer.
  • Организации, поддерживающие поставщиков собраний по сети, например Microsoft Teams и Скайп, могут настроить календари Outlook так, чтобы использовать этих поставщиков. Вы можете легко организовывать и посещать мероприятия в этих календарях как собрания по сети.

Создание приложений с учетом сведений о расположениях и предоставлением интеллектуального контекста

Используйте API мест, чтобы предоставлять пользователям маршрут до места или интеллектуальное решение на основе расположения пользователя. Ниже рассмотрены примеры некоторых сценариев.

  • Добавьте сведения о местах в события календаря, чтобы облегчить для пользователей повседневную работу и повысить производительность.**
  • Приложения из сферы питания могут использовать API мест для указания пути к месту проведения и подготовки.**
  • Автоматизируйте отправку предварительных сведений о собрании на электронную почту участников и добавьте карту с маршрутом к помещению.**
  • Настройте ботов-помощников в приемной, чтобы предоставлять сведения о конкретных помещениях в здании.**

В зависимости от сценария приложения вы можете использовать API мест в контексте Outlook или независимо от Outlook.

Использование социальной аналитики и других удобных для разработчика возможностей в Microsoft Graph

С помощью API людей в Microsoft Graph вы можете подключаться к данным людей, основанным на шаблонах общения и работы, а также на бизнес-связях. Вы можете реализовать различные элементы управления, например средство выбора людей, и предлагать людей, релевантных для пользователя, при организации собраний от имени пользователя.

Уменьшите издержки на хранение данных приложений и управление ими во внешних хранилищах данных. С помощью Microsoft Graph вы можете хранить пользовательские данные приложений в качестве открытых расширений в отдельных экземплярах ресурсов. Если требуется вводить данные или необходима возможность делиться введенной схемой, вы можете сохранить пользовательские данные приложений в расширениях схемы.

Расположение данных

API Microsoft Graph поддерживает доступ к данным в основных и общих почтовых ящиках пользователей. Данные могут быть календарем, почтой или личными контактами, хранящимися в почтовом ящике в облаке Exchange Online в составе Microsoft 365.

API не поддерживает доступ к почтовым ящикам архива на месте ни на сервере Exchange Online, ни на сервере Exchange Server.

Справочные материалы по API

Ищете справочные материалы по API для этой службы?

Связанные материалы