Outlook アドインAPI プレビュー要件セット

  • [アーティクル]

Office JavaScript API の Outlook アドイン API サブセットには、Outlook アドインで使用できるオブジェクト、メソッド、プロパティ、イベントが含まれています。

プレビュー API は変更される可能性があり、運用環境での使用を目的としたものではありません。 試用はテスト環境と開発環境に限定することをお勧めします。 運用環境やビジネス クリティカルなドキュメント内でプレビュー API を使用しないでください。

プレビュー API を使用するには:

  • Office.js コンテンツ配信ネットワーク (CDN) から Office JavaScript API ライブラリのプレビュー バージョンを使用する必要があります。 TypeScript コンパイルおよび IntelliSense の 型定義ファイルは CDN で見つかり、DefinitelyTyped にあります。 これらの型は を使用して npm install --save-dev @types/office-js-preview インストールできます (以前にインストールした場合は、 の @types/office-js 型を必ず削除してください)。

  • Outlook on Windows および Mac で最新の Office ビルドにアクセスするには、 Microsoft 365 Insider プログラム に参加することが必要になる場合があります。

  • Microsoft 365 テナントでターゲット リリース オプションを構成して、Outlook on the webの機能をプレビューする必要がある場合があります。 詳細については、「 Standard または Targeted リリース オプションを設定する」の「ターゲット リリース」セクションを参照してください。

プレビュー要件セットには、 要件セット 1.13 のすべての機能が含まれています。

重要

このドキュメントは、 プレビュー要件セット用です。 この要件セットはまだ完全に実装されていないため、クライアントはサポートを正確に報告しません。 アドイン マニフェストでは、この要件セットを指定しないでください。

プレビューの機能

次の機能はプレビュー段階です。

読み取りモードでメッセージに対してイベント ベースのアドインをアクティブ化する

OnMessageReadWithCustomAttachment イベントと OnMessageReadWithCustomHeader イベント

特定の添付ファイルの種類またはカスタム インターネット ヘッダーが含まれている場合に、読み取りモードでメッセージに対してイベント ベースのアドインをアクティブ化するイベントを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

LaunchEvent 要素の HeaderName 属性

イベントが発生する <インターネット ヘッダー名を指定するために、LaunchEvent> XML 要素に属性を OnMessageReadWithCustomHeader 追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

MessageAttachments 要素

イベントが発生するメッセージに含まれる添付ファイルのファイル拡張子を指定する XML 要素を OnMessageReadWithCustomAttachment 追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


その他の予定表プロパティ

Office.IsAllDayEvent

新規作成モードの予定の終日イベント プロパティを表す新しいオブジェクトを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.Sensitivity

新規作成モードでの予定の秘密度レベルを表す新しいオブジェクトを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

Office.context.mailbox.item.isAllDayEvent

予定が終日イベントであるかどうかを表す新しいプロパティを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.context.mailbox.item.sensitivity

予定の機密性を表す新しいプロパティを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

Office.MailboxEnums.AppointmentSensitivityType

予定で使用できる秘密度オプションを表す新しい列挙型 AppointmentSensitivityType を追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)


追加のメッセージ メンバー

Office.context.mailbox.item.inReplyTo

現在のメッセージによって返信される元のメッセージのメッセージ ID を取得するプロパティを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.context.mailbox.item.getConversationIndexAsync

スレッド スレッド内の現在のメッセージの Base64 でエンコードされた位置を取得するメソッドを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.context.mailbox.item.getItemClassAsync

メッセージの Exchange Web Services (EWS) アイテム クラスを作成モードで取得するメソッドを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


compose でメッセージを閉じて破棄する

Office.context.mailbox.item.closeAsync

未保存の変更を破棄するオプションで構成されている現在のメッセージを閉じるメソッドを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


アドインの JavaScript ランタイムの URL を取得する

Office.context.urls.javascriptRuntimeUrl

アドインの JavaScript ランタイムの URL を取得するプロパティを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


統合スパム レポート

ReportPhishingCommandSurface 拡張ポイント

Outlook リボンでスパムレポート アドインをアクティブ化し、リボンの最後またはオーバーフロー セクションに表示されないようにするための拡張機能ポイントを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

ReportPhishingCustomization 要素

リボン ボタンとスパム レポート アドインの前処理ダイアログを構成するマニフェスト要素を追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

Office.context.mailbox.item.getAsFileAsync

メッセージの Base64 エンコードを取得するメソッドを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

Office.SpamReportingEventCompletedOptions

受信トレイから削除するなど、報告されたメッセージに対して追加の操作を実行するように、後処理ダイアログをカスタマイズしたり、スパムレポート アドインを構成したりするためのオプションを作成しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

Office.MailboxEnums.MoveSpamItemTo

報告されたメッセージがスパム レポート アドインによって処理された後に移動されるフォルダーを指定する新しい列挙型を追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)、Outlook on Mac (Microsoft 365 サブスクリプション)、Outlook on the web (モダン)、新しい Outlook on Windows (プレビュー)

アドインに統合スパムレポート機能を実装する方法の詳細については、「 統合スパムレポート アドインの実装 (プレビュー)」を参照してください。


項目の複数選択: 追加のメッセージ プロパティ

Office.SelectedItemDetails

Office.context.mailbox.getSelectedItemsAsync を使用して Outlook で選択したメッセージのプロパティを取得する機能が、要件セット 1.13 で導入されました。 、、、 hasAttachmentなどのconversationIdinternetMessageIdその他のプロパティをプレビューで使用できるようになりました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


Office テーマ

Office.context.officeTheme

Office テーマを取得する機能が追加されました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.EventType.OfficeThemeChanged

OfficeThemeChanged イベントが Mailbox に追加されました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


スマート アラート: [送信しない] オプションをカスタマイズし、実行時に送信モード オプションをオーバーライドする

Office.SmartAlertsEventCompletedOptions: その他のオプション

[スマート アラート] ダイアログの [送信しない] ボタンをカスタマイズし、実行時に送信モード オプションをオーバーライドするオプションを追加event.completedしました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.MailboxEnums.SendModeOverride

実行時にマニフェストで設定されたオプションをオーバーライドする送信モード オプションを指定する列挙型を追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

これらの機能を実装する方法については、 スマート アラートのチュートリアルを参照してください。


読み取りモードで表示される本文または件名を一時的に設定する

Office.context.mailbox.item.display

メッセージの本文または件名に表示されるコンテンツを読み取りモードで一時的に設定するオブジェクトを取得するプロパティを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.Display

メッセージの本文または件名に表示されるコンテンツを読み取りモードで一時的に設定するプロパティを提供するオブジェクトを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.DisplayedBody

読み取りモードでメッセージの本文に表示されるコンテンツを一時的に設定するメソッドを提供するオブジェクトを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)

Office.DisplayedSubject

メッセージの件名に表示されるコンテンツを読み取りモードで一時的に設定するメソッドを提供するオブジェクトを追加しました。

利用可能: Outlook on Windows (Microsoft 365 サブスクリプション)


関連項目