Outlook 外接程序API 预览要求集

Office JavaScript API 的 Outlook 外接程序 API 子集包括可在 Outlook 外接程序中使用的对象、方法、属性和事件。

预览版 API 可能会发生更改,不适合在生产环境中使用。 我们建议你仅在测试和开发环境中试用它们。 请勿在生产环境或业务关键型文档中使用预览 API。

若要使用预览 API:

预览版要求集包括 要求集 1.13 的所有功能。

重要

本文档适用于 预览要求集。 此要求集尚未完全实现,客户端不会准确报告对它的支持。 不应在外接程序清单中指定此要求集。

预览阶段的功能

以下是预览版中的功能。

在阅读模式下对邮件激活基于事件的加载项

OnMessageReadWithCustomAttachment 和 OnMessageReadWithCustomHeader 事件

添加了事件,以在邮件中包含某些附件类型或自定义 Internet 标头时,在邮件上激活基于事件的加载项。

:Outlook on Windows (Microsoft 365 订阅)

LaunchEvent 元素中的 HeaderName 属性

向 LaunchEvent XML 元素添加了一个属性<,以指定发生事件的 Internet 标头名称。>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 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)

Office.context.mailbox.item.isAllDayEvent

添加了一个新属性,该属性表示约会是否为全天事件。

:Outlook on Windows (Microsoft 365 订阅)

Office.context.mailbox.item.sensitivity

添加了一个表示约会敏感度的新属性。

以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)

Office.MailboxEnums.AppointmentSensitivityType

添加了表示约会上可用的敏感度选项的新枚举 AppointmentSensitivityType

以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)




在撰写中关闭并放弃邮件

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 订阅)

ReportPhishingCustomization 元素

添加了一个 manifest 元素,用于配置垃圾邮件报告加载项的功能区按钮和预处理对话框。

:Outlook on Windows (Microsoft 365 订阅)

Office.context.mailbox.item.getAsFileAsync

添加了一个方法,用于获取消息的 Base64 编码。

:Outlook on Windows (Microsoft 365 订阅)

Office.SpamReportingEventCompletedOptions

已创建用于自定义后期处理对话框或配置垃圾邮件报告加载项的选项,以对报告的邮件执行其他操作,例如从收件箱中删除它。

:Outlook on Windows (Microsoft 365 订阅)

Office.MailboxEnums.MoveSpamItemTo

添加了一个新的枚举,以指定在垃圾邮件报告加载项处理报告邮件后,将邮件移动到的文件夹。

:Outlook on Windows (Microsoft 365 订阅)

若要详细了解如何在外接程序中实现集成的垃圾邮件报告功能,请参阅 实现集成的垃圾邮件报告加载项 (预览版)




项多选:其他消息属性

Office.SelectedItemDetails

要求集 1.13 中引入了使用 Office.context.mailbox.getSelectedItemsAsync 在 Outlook 中获取所选邮件的属性的功能。 其他属性(如 conversationIdinternetMessageIdhasAttachment)现在以预览版提供。

:Outlook on Windows (Microsoft 365 订阅)




Office 主题

Office.context.officeTheme

增加了获取 Office 主题的功能。

:Outlook on Windows (Microsoft 365 订阅)

Office.EventType.OfficeThemeChanged

Mailbox 中添加了 OfficeThemeChanged 事件。

: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 订阅)




另请参阅