Outlook插件部署最低服务器要求?调用API报平台不支持错误
Outlook插件托管与SSO接口报错问题解答
你遇到的"API is not supported in this platform"报错和托管服务器本身的基础配置无关,是运行Outlook客户端的Windows Server系统对Office JS API的支持性差异导致的。
注意:托管服务器仅负责提供插件的静态资源分发,不会影响Office JS API的执行支持性,API的兼容性完全由运行插件的客户端设备环境决定
报错原因说明
OfficeRuntime.auth.getAccessToken属于Office JS Identity API 1.3 版本的接口,该接口的正常运行依赖客户端设备同时满足两个条件:一是Office版本为Microsoft 365订阅版且内部版本号≥16.0.13127.20000,二是设备上安装了符合版本要求的WebView2运行时。- Windows Server 2016默认未预安装WebView2运行时,且旧版WebView2在Server 2016系统上对Office JS API的适配存在已知兼容性问题;Windows Server 2019及以上版本的系统对WebView2的兼容性更好,默认预装的运行时版本可以满足Identity API 1.3的运行要求。
修复方案
如果需要在Windows Server 2016环境下正常使用该插件的SSO功能,可以按以下步骤排查修复:
- 手动在Windows Server 2016设备上安装最新版WebView2运行时,安装完成后重启Outlook客户端重试。
- 升级该设备上的Office客户端到最新补丁版本,确认版本号满足Identity API 1.3的支持要求。
- 在插件代码中增加兼容性判断逻辑,避免在不支持的环境下直接调用接口导致报错,示例代码如下:
if (Office.context.requirements.isSetSupported('IdentityAPI', '1.3')) { let tokenData = await OfficeRuntime.auth.getAccessToken({ allowSignInPrompt: true }); // 后续token处理逻辑 } else { // 兼容逻辑:使用弹窗授权等替代方案完成身份验证 }
内容的提问来源于stack exchange,提问作者Margie
相关产品推荐
相关产品推荐

