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
。你可能需要加入 Microsoft 365 预览体验计划 ,才能访问 Windows 和 Mac 版 Outlook 中更新的 Office 版本。
可能需要在 Microsoft 365 租户上配置“目标发布”选项,以预览 Outlook 网页版 中的功能。 有关详细信息,请参阅 设置标准或目标发布选项的“目标发布”部分。
预览版要求集包括 要求集 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.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 订阅)
在撰写中关闭并放弃邮件
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 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)
ReportPhishingCustomization 元素
添加了一个 manifest 元素,用于配置垃圾邮件报告加载项的功能区按钮和预处理对话框。
以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)
Office.context.mailbox.item.getAsFileAsync
添加了一个方法,用于获取消息的 Base64 编码。
以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)
Office.SpamReportingEventCompletedOptions
已创建用于自定义后期处理对话框或配置垃圾邮件报告加载项的选项,以对报告的邮件执行其他操作,例如从收件箱中删除它。
以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)
Office.MailboxEnums.MoveSpamItemTo
添加了一个新的枚举,以指定在垃圾邮件报告加载项处理报告邮件后,将邮件移动到的文件夹。
以下版本:Outlook on Windows (Microsoft 365 订阅) 、Mac 版 Outlook (Microsoft 365 订阅) 、Outlook 网页版 (新式) 、新的 Outlook on Windows (预览版)
若要详细了解如何在外接程序中实现集成的垃圾邮件报告功能,请参阅 实现集成的垃圾邮件报告加载项 (预览版) 。
项多选:其他消息属性
Office.SelectedItemDetails
要求集 1.13 中引入了使用 Office.context.mailbox.getSelectedItemsAsync 在 Outlook 中获取所选邮件的属性的功能。 其他属性(如 conversationId
、 internetMessageId
和 hasAttachment
)现在以预览版提供。
在: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 订阅)
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈