MAPI
Concept
MAPI(Messaging Application Programming Interface)は、ExchangeおよびOutlookの基盤となる独自仕様のMicrosoftメッセージングAPIおよびデータモデルであり、そのレガシーなデータ構造は、現在のExchange開発にも影響を与え続けています。
Description
MAPI(Messaging Application Programming Interface)は、ExchangeおよびOutlookの基盤となる、Microsoftの独自仕様のメッセージングAPIおよびデータモデルです。開発者が新しいインターフェイスを使ってExchangeのデータにアクセスする場合でも、そのレガシーなデータ構造は今日のExchangeデータの扱い方に影響を与えています。この用語は、プログラミングインターフェイスそのものを指す場合と、その下でメールボックスの内容がモデル化される仕組みを指す場合の両方で使われます。
Microsoft Learnのリファレンスによると、MAPIはMicrosoft Outlook Messaging APIであり、Outlook 2013およびOutlook 2016のメッセージングアーキテクチャを提供します。開発者がOutlookのメッセージングアプリケーションを構築する際に使用するインターフェイス、関数、データ型を提供します。アプリケーションやトランスポートは、MAPIを使ってメールデータを扱い、メッセージとそれを格納するフォルダーを作成し、MAPI関連のデータが変更されたときに通知を受け取ります。このリファレンスページはOutlook 2013およびOutlook 2016にのみ適用され、個々のインターフェイス、関数、コード例は掲載されていません。
Microsoft Learnのリファレンスは、4つの部分で構成されています。入門の概要、サンプルアプリケーション、MAPIの理解とプログラミングに関するコンセプトガイド、そしてプログラミング要素のリファレンスです。この分野に初めて触れる開発者向けに、このページではOutlookソリューション開発に適したAPIやテクノロジーの選択について解説した別の記事を紹介しています。このガイダンスは、MAPIが複数の選択肢の一つであり、どれを選ぶかは構築するソリューションの種類によって決まるという、よくある判断を反映しています。
実際には、既存のコードを新しいテクノロジーに移行する必要がある場合に、MAPIが最も重要になります。M365.FMのエピソード「Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]」がこの点に触れています。このエピソードでは、Exchange Web ServicesからMicrosoft Graphに移行する際、特にアーカイブメールボックスやパブリックフォルダーが関係するワークフローには特別な注意が必要だと述べています。また、MAPI拡張プロパティを使って生のMIMEからメールを作成する場合、そのアプローチは変更なしには移行できないため、ワークフローの見直しが必要になることがあるとも述べています。高度なデルタセマンティクスも、EWSとGraphの間の違いの一つとして挙げられており、コードの一部を作り直す必要があるかもしれません。
このエピソードでは、これらの点を移行の課題を示す表として紹介しています。アーカイブメールボックスへのアクセスや、一部のメールボックスのインポートおよびエクスポートのワークフローには特別な注意が必要であること、パブリックフォルダーのシナリオでは依存関係についてMicrosoftへの確認が必要であること、そして高度なデルタセマンティクスは2つの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.
| Type | Concept |
|---|---|
| Wikipedia | MAPI – 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)は、ExchangeおよびOutlookの基盤となる、Microsoftの独自仕様のメッセージングAPIおよびデータモデルです。Microsoft Learnでは、Outlook 2013およびOutlook 2016のメッセージングアーキテクチャを提供するものとして説明されています。
MAPIを使ってアプリケーションは何ができますか? (AI)
アプリケーションやトランスポートは、MAPIを使ってメールデータを扱い、メッセージとそれを格納するフォルダーを作成し、MAPI関連のデータが変更されたときに通知を受け取ります。
なぜExchange Web ServicesからMicrosoft Graphへの移行でMAPIが話題になるのですか? (AI)
エピソード「Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]」では、Graphへ移行する際、MAPI拡張プロパティを使って生のMIMEからメールを作成する方法は、ワークフローの見直しが必要になる場合があると述べられています。
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
- MAPI – Wikipedia en.wikipedia.org
- Outlook MAPI Reference – Microsoft Learn learn.microsoft.com
Maintained by Mirko Peters (Microsoft MVP) · Last updated: