M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions m365con.net

MAPI

Concept

MAPI (Messaging Application Programming Interface) — это проприетарный программный интерфейс обмена сообщениями и модель данных Microsoft, лежащие в основе Exchange и Outlook, устаревшие структуры данных которых до сих пор влияют на разработку для Exchange.

✦ CONCEPTMAPIM365.FM
Title graphic: MAPI (Concept)

Description

MAPI, сокращение от Messaging Application Programming Interface, — это проприетарный программный интерфейс обмена сообщениями и модель данных Microsoft, на которых построены Exchange и Outlook. Её устаревшие структуры данных до сих пор влияют на то, как разработчики работают с данными Exchange, даже когда они используют более новые интерфейсы для доступа к ним. Этот термин употребляется и для обозначения самого программного интерфейса, и для описания того, как содержимое почтовых ящиков моделируется на его основе.

Согласно справочнику Microsoft Learn, MAPI — это Microsoft Outlook Messaging API, который обеспечивает архитектуру обмена сообщениями для Outlook 2013 и Outlook 2016. Он предоставляет интерфейсы, функции и типы данных, которые разработчики используют для создания приложений обмена сообщениями в Outlook. Приложения и транспортные компоненты используют MAPI для работы с данными электронной почты, для создания сообщений и папок, в которых они хранятся, а также для получения уведомлений при изменении данных, связанных с MAPI. Справочная страница относится только к Outlook 2013 и Outlook 2016 и не перечисляет отдельные интерфейсы, функции или примеры кода.

Справочник Microsoft Learn состоит из четырёх частей: вводного обзора для начала работы, примеров приложений, концептуальных руководств по пониманию и программированию с MAPI и справочника по программным элементам. Для разработчиков, впервые знакомящихся с этой областью, страница ссылается на отдельную статью о выборе подходящего API или технологии для разработки решений для Outlook. Эта рекомендация отражает распространённую задачу: MAPI — лишь один из нескольких вариантов, и выбор зависит от типа создаваемого решения.

На практике MAPI наиболее важен тогда, когда существующий код нужно перенести на более новые технологии. Эпизод M365.FM «Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]» затрагивает эту тему. В эпизоде отмечается, что некоторые рабочие процессы требуют особого внимания при переходе с Exchange Web Services на Microsoft Graph, особенно связанные с архивными почтовыми ящиками или общими папками. Там также говорится, что создание почты из необработанного MIME с помощью расширенных свойств MAPI может потребовать пересмотра рабочего процесса, поскольку такой подход не переносится без изменений. Расширенная семантика delta перечислена как ещё одно различие между EWS и Graph, которое может потребовать переработки отдельных частей кода.

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

Для администраторов и разработчиков практический вывод таков: знание MAPI остаётся актуальным для чтения старого кода Exchange и Outlook, для понимания того, как структурированы сообщения, папки и уведомления, и для оценки трудозатрат на переход на Microsoft Graph. Поскольку доступные источники описывают MAPI главным образом в контексте Outlook 2013 и Outlook 2016 и миграции с EWS на Graph, тем, кто планирует работу, следует уточнять актуальную поддержку и требования в официальной документации для конкретного сценария.

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept
WikipediaMAPI – Wikipedia en.wikipedia.org

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

Что такое MAPI? (AI)

MAPI (Messaging Application Programming Interface) — это проприетарный программный интерфейс обмена сообщениями и модель данных Microsoft, лежащие в основе Exchange и Outlook. Microsoft Learn описывает его как обеспечивающий архитектуру обмена сообщениями для Outlook 2013 и Outlook 2016.

Что приложения могут делать с помощью MAPI? (AI)

Приложения и транспортные компоненты используют MAPI для работы с данными электронной почты, для создания сообщений и папок, в которых они хранятся, а также для получения уведомлений при изменении данных, связанных с MAPI.

Почему MAPI возникает при миграции с Exchange Web Services на Microsoft Graph? (AI)

В эпизоде «Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]» говорится, что создание почты из необработанного MIME с помощью расширенных свойств MAPI может потребовать пересмотра рабочих процессов при переходе на Graph.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Sources

Maintained by Mirko Peters (Microsoft MVP) · Last updated: