Поделиться через

Обзор API для личных контактов Outlook

  • Статья

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

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

Расширение сценариев обмена сообщениями и ведения календаря для сотен миллионов клиентов

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

Автоматизация организации контактов

API контактов позволяет упорядочивать ваших клиентов аналогично тому, как это делают в Outlook сами клиенты:

  • Точно так же, как клиенты, вы можете создавать экземпляры контактов и назначать их объектам contactFolder.
  • API контактов позволяет назначать категории контактам, а также событиям, сообщениям, задачам и записям в группах, чтобы упорядочить эти элементы и упростить их поиск. Кроме того, вы можете определить основной список категорий пользователя, что позволит использовать дополнительные нестандартные сценарии.
  • Контакт можно пометить для последующего наблюдения. (В настоящее время функция пометки доступна в предварительной версии в Microsoft Graph.)

Общий доступ к информации контактов

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

Использование API людей в Microsoft Graph для более эффективного использования всех данных пользователей

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

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

  • Сущность contact поддерживает фотографию контакта, которая реализуется как та же сущность profilePhoto, что и фотография пользователя, хранящуюся в Exchange Online или Microsoft Entra ID. Это позволяет исключить потребление ресурсов при преобразовании между фотографией контакта и фотографией профиля пользователя.
  • Вы можете синхронизировать локальное хранилище приложения, подписавшись на уведомления об изменениях и отслеживание изменений в контактах и папках контактов.
  • Вы можете увеличить хранилище приложения в экземпляре контакта в виде открытого расширения или добавить строго типизированные пользовательские данные в схему контакта в виде расширения схемы.

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

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

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

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

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

Дальнейшие действия