Microsoft Graph API执行Excel脚本的替代方案及相关疑问

一、Graph API中getScripts、executeScripts方法的状态 #

是的，这些旧版Excel脚本相关端点已被废弃并移除，调用时返回“no segment found”错误属于预期结果。目前Microsoft Graph Excel API已不再支持这类旧端点，官方已转向基于Office Scripts的新API体系。

二、除Power Automate外的替代方案 #

1. Office Scripts + Graph API执行刷新 #

• 先在Excel Online中创建Office Script，实现链接/连接的刷新逻辑（比如调用workbook.refreshAllConnections()方法）
• 获取脚本ID（可在Excel网页版的脚本编辑器中查看）
• 调用Graph API的POST /sites/{site-id}/drive/items/{item-id}/workbook/runScript端点，传入脚本ID执行刷新
• 所需权限：Files.ReadWrite.All或Sites.ReadWrite.All（根据工作簿所在位置选择）

2. 直接调用Excel连接刷新API #

若仅需刷新特定工作簿连接，可直接使用：

POST /sites/{site-id}/drive/items/{item-id}/workbook/connections/{connection-id}/refresh

该端点无需脚本，直接触发指定连接的刷新，适配外部工作簿链接这类场景。

3. 使用Microsoft 365 CLI #

通过命令行工具实现自动化操作：

• 刷新指定工作簿的目标连接：

  m365 excel workbook connection refresh --siteUrl https://contoso.sharepoint.com/sites/team --filePath "Documents/Report.xlsx" --connectionName "ExternalWorkbookLink"
  

• 运行已创建的Office Script：

  m365 excel workbook script run --siteUrl https://contoso.sharepoint.com/sites/team --filePath "Documents/Report.xlsx" --scriptId "abc123-xyz456"
  

适合批量操作或集成到Shell脚本中。

4. Azure Functions自定义触发 #

将Graph API调用逻辑封装到Azure Functions中，可设置定时触发、HTTP触发等方式，实现自定义刷新调度。比如用C#或Python编写函数，调用runScript或refresh端点，灵活适配业务需求。

三、额外注意事项 #

• 确保调用API的身份（应用或用户）同时拥有源工作簿和目标工作簿的访问权限，否则刷新会失败
• 先手动测试Office Script或连接刷新逻辑，确认在Excel网页版中可正常执行后，再通过API调用
• 大型工作簿的刷新操作耗时较长，建议添加异步处理逻辑或状态查询机制

内容的提问来源于stack exchange，提问作者Ansonee