大网数据广告活动
Microsoft Graph 接口

在 Excel 中管理会话和持久性

· 52CE 我爱测

了解如何以最有效的方式在 Microsoft Graph 中使用 Excel API。 了解调用 API 的三种模式以及相关的请求类型。

如果应用程序需要对 Microsoft Graph 中的 Excel API 进行一两次以上的调用,请创建一个会话,并通过每个请求传递会话 ID。 请求中存在会话 ID 可确保以最有效的方式使用 Excel API。

可通过以下三个模式之一下调用 Excel API:

  • 持久会话: 对工作簿所做的所有更改将保留 (保存到工作簿) 。 这是使用 Excel API 最高效且性能最佳的方式。

  • 非持久会话: API 所做的更改不会保存到源位置。 而是,Excel 后端服务器将保留文件的临时副本,用于反映在特定 API 会话期间所做的更改。 Excel 会话过期时,这些更改将丢失。 此模式可用于需要进行分析或获得计算结果或图表图像的应用,但不会影响文档状态。

  • 无会话: API 调用不会传递会话 ID。 Excel 服务器必须查找每个操作的工作簿的服务器副本。 这不是调用 Excel API 的有效方式,但它适用于进行某些类型的隔离请求。

若要表示 API 中的会话,请使用 workbook-session-id: {session-id} 标头。

Note: Excel API 无需使用会话标头。 但是,建议你使用会话标头来提高性能。 如果不使用会话标头,API 调用过程中进行的更改 仅 保持在该文件中。

请求类型

建议的 Excel API 错误处理 基于请求类型、错误代码和状态代码。 下面是请求类型:

  • CreateSession 请求: 用于创建持久性会话或非永久性会话。 在成功响应中,会话 ID 将在响应正文中的 ID 属性中返回。 有关详细信息,请参阅 “创建会话”。
  • 会话请求: 遵循 CreateSession 请求的后续请求。 它们通常包含标 workbook-session-id: {session-id} 头。 异常是使用长时间运行的操作模式的轮询状态请求。 有关详细信息,请参阅使用 需要很长时间才能完成的 API。
  • 无会话请求: 在无会话模式下使用。 这些请求没有 workbook-session-id: {session-id} 标头。

后续步骤

要了解如何创建和使用会话,请参阅创建会话参考主题。

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 lumine2008)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。