Outlook アドインの概要

Outlook アドインとは、Microsoft の Web ベース プラットフォームを使用して Outlook に組み込まれるサードパーティ製の統合機能です。 Outlook アドインには次の 3 つの主な側面があります。

• 同じアドインとビジネス ロジックは、Web (Microsoft 365 と Outlook.com)、デスクトップ (Windows と Mac の Outlook)、モバイル全体で機能します。
• Outlook アドインは、マニフェスト (アドインが Outlook に統合する方法 (ボタンや作業ウィンドウなど) を説明する)、および JavaScript/HTML のコード (アドインの UI とビジネス ロジックを構成する) で構成される。
• Outlook アドインは、AppSource から入手するか、エンドユーザーまたは管理者がサイドロードすることができます。

Outlook アドインは、Windows 版 Outlook 固有の統合機能として以前から存在した COM アドインや VSTO アドインとは異なります。 COM アドインとは違い、Outlook アドインのコードがユーザーのデバイスまたは Outlook クライアントに物理的にインストールされることはありません。 Outlook のアドインの場合、Outlook はマニフェストを読み取り UI で指定したコントロールをフックした後に、HTML と JavaScript を読み込みます。 Web コンポーネントはすべて、サンドボックス内のブラウザーまたは Webview コントロールのコンテキストで実行されます。

重要

COM アドインと VSTO アドインは、現在プレビュー段階の 新しい Outlook on Windows ではサポートされていません。 これらのアドインは、従来の Outlook on Windows デスクトップ クライアントで引き続きサポートされています。 詳細については、「 新しい Outlook on Windows 用 Outlook アドインの開発 (プレビュー)」を参照してください。

アドインをサポートしている Outlook アイテムには、メール メッセージ、会議出席依頼、会議出席依頼の返信、会議の取り消し、予定などがあります。 それぞれの Outlook アドインにより、アイテムの種類、ユーザーがアイテムの読み取りや作成を行うかどうかなど、使用できるコンテキストが定義されます。

注:

アドインを AppSource に 公開 し、Office エクスペリエンス内で利用できるようにする場合は、商用マーケットプレイスの認定ポリシー に準拠していることを確認してください。 たとえば、検証に合格するには、アドインは、定義したメソッドをサポートするすべてのプラットフォーム全体で機能する必要があります (詳細については、セクション 1120.3 と「Office アドイン アプリケーションと可用性」のページを参照してください)。

拡張点

拡張点は、アドインが Outlook と統合する方法です。 これを行う方法を次に示します。

• アドインは、メッセージと予定のコマンド サーフェスに表示されるボタンを宣言できます。 詳細については、「 アドイン コマンド」を参照してください。

  

• アドインは、メッセージおよび予定内の正規表現に一致するものや検出されたエンティティのリンクをオフにすることができます。 詳細は、「コンテキスト Outlook アドイン」をご覧ください。

  重要

  エンティティベースのコンテキスト Outlook アドインは、2024 年第 2 四半期に廃止される予定です。 この機能を廃止する作業は 5 月に開始され、6 月末まで継続されます。 6 月以降、コンテキスト アドインはメール アイテム内のエンティティを検出してタスクを実行できなくなります。 次の API も廃止されます。

  • Office.context.mailbox.item.getEntities()
  • Office.context.mailbox.item.getEntitiesByType(entityType)
  • Office.context.mailbox.item.getFilteredEntitiesByName(name)
  • Office.context.mailbox.item.getSelectedEntities()

  中断の可能性を最小限に抑えるために、エンティティ ベースのコンテキスト アドインが廃止された後も、次の機能がサポートされます。

  • オンライン会議アドインによってアクティブ化される [会議に参加 ] ボタンの代替実装が開発されています。 エンティティベースのコンテキスト アドインのサポートが終了すると、オンライン会議アドインは自動的に別の実装に移行して [ 会議に参加 ] ボタンをアクティブ化します。
  • エンティティ ベースのコンテキスト アドインが廃止された後も、正規表現ルールは引き続きサポートされます。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。

  詳細については、「 エンティティ ベースのコンテキスト Outlook アドインの廃止」を参照してください。

  

アドインで使用可能なメールボックスのアイテム

Outlook アドインは、ユーザーがメッセージまたは予定を作成または読んでいるときにアクティブになりますが、他の種類のアイテムではアクティブになりません。 ただし、現在のメッセージ アイテムが作成または読み取りフォームで次のいずれかである場合、アドインはアクティブ化されません。

• Information Rights Management (IRM) によって保護されるか、保護のために他の方法で暗号化され、モバイル デバイス上の Outlook からアクセスされます。 デジタル署名は、これらのメカニズムのいずれかに依存するため、デジタル署名されたメッセージの例です。 Outlook アドインでの IRM サポートの詳細については、「 IRM によって保護されたメール アイテム」を参照してください。

• [ プログラムによるアクセスを許可する ] カスタム ポリシー オプションが に false設定されている秘密度ラベルを持つ IRM で保護されたメール アイテム。 Outlook アドインでの IRM サポートの詳細については、「 IRM によって保護されたメール アイテム」を参照してください。

• メッセージ クラスが IPM.Report.* である配信レポートまたは通知 (配信レポート、配信不能レポート (NDR)、開封通知、未開封通知、遅延通知など)。

• 別のメッセージに添付される .msg または .eml ファイルの場合。

• .msg または .eml ファイルがファイル システムから開かれた場合。

• グループ メールボックス、共有メールボックス*、別のユーザーのメールボックス*、アーカイブ メールボックス、またはパブリック フォルダー内。

  重要

  * 委任アクセス シナリオのサポート (たとえば、別のユーザーのメールボックスから共有されたフォルダー) は 要件セット 1.8 で導入されましたが、共有メールボックスのサポートは 要件セット 1.13 で導入されました。 詳細については、「 共有フォルダーと共有メールボックスのシナリオを有効にする」を参照してください。

• カスタム フォームを使用する場合。

• 簡易 MAPI で作成されます。 簡易 MAPI は、Outlook が閉じられている間に Office ユーザーが Windows 上の Office アプリケーションからメールを作成または送信するときに使用されます。 たとえば、ユーザーは Word での作業中に Outlook メールを作成できます。これにより、Outlook アプリケーション全体を起動せずに Outlook メール作成ウィンドウがトリガーされます。 ただし、ユーザーが Word からメールを作成するときに Outlook が既に実行されている場合、これは簡易 MAPI シナリオではないため、Outlook アドインは、他のアクティブ化要件が満たされている限り、作成フォームで動作します。

既知のエンティティの文字列照合に基づいてアクティブ化されるアドインを除いて、通常、Outlook は [送信済みアイテム] フォルダーのアイテムに対して閲覧フォーム内でアドインをアクティブ化できます。 この背後にある理由の詳細については、「既知のエンティティに対するサポート」をご覧ください。

現在、モバイル クライアント用のアドインを設計および実装する際には、さらに考慮事項があります。 詳細については、「 モバイル デバイス上の Outlook でアドイン コマンドのサポートを追加する」を参照してください。

IRM によって保護されたメール アイテム

Outlook アドインは、次のサポートされているクライアントからアイテムにアクセスすると、IRM で保護されたメール アイテムに対してアクティブ化されます。

• Outlook on the web

• Windows 上の新しい Outlook (プレビュー)

• バージョン 2009 以降のクラシック Outlook on Windows (ビルド 13229.10000)

  注:

  デジタル署名は、IRM などの保護メカニズムに依存します。 Microsoft 365 サブスクリプションに関連付けられている Outlook on Windows バージョン 1711 (ビルド 8711.1000) 以降、アドインはデジタル署名されたメッセージでアクティブ化されます。

• バージョン 16.77.827.0 以降の Outlook on Mac

ただし、次の場合、アドインは IRM で保護されたアイテムに対してアクティブ化されません。

• IRM で保護されたアイテムは、モバイル デバイスの Outlook からアクセスされます。
• IRM で保護された項目には秘密度ラベルがあり、[ プログラムによるアクセスを許可する ] カスタム ポリシー オプションが に false設定されています。 カスタム ポリシー オプションの詳細については、「 使用権限と説明」を参照してください。

サポートされるクライアント

Outlook アドインは、Outlook on Windows (クラシックおよび新規 (プレビュー))、Outlook on Mac、Outlook on the web、Outlook on iOS、Outlook on Android、Outlook.com でサポートされています。 すべての最新機能がすべてのクライアントで同時にサポートされるとは限りません。 クライアントとサーバーでの機能サポートの詳細については、「 Exchange サーバーと Outlook クライアントでサポートされる要件セット」と 、それらの機能に固有の記事を参照してください。

Outlook アドインの作成を開始する

Outlook アドインの作成を開始するには、次の操作を行います。

• クイックスタート - 簡単な作業ウィンドウを作成します。
• チュートリアル - 新しいメッセージに GitHub gist を挿入するアドインを作成する方法について説明します。

関連項目

• Microsoft 365 開発者プログラムについて
• Office アドイン開発のベスト プラクティス
• Office アドインの設計ガイドライン
• Office および SharePoint アドインのライセンスを付与する
• Office アドインを発行する
• AppSource と Office 内でソリューションを使用できるようにする