使用Microsoft Graph SDK获取DocumentSetVersions时遇ODataError参数不可接受

问题背景 #

尝试通过Microsoft Graph SDK获取SharePoint站点中特定列表项的DocumentSetVersions列表，返回错误：ODataError: 提供的参数之一不可接受。已确认GraphClient、siteId、listId、itemId均有效，且目标列表已启用版本控制。使用的代码如下：

var result = await _graphClient.Sites[siteId].Lists[listId].Items[itemId].DocumentSetVersions.GetAsync();

排查及解决方向 #

• 确认目标列表项是文档集：DocumentSetVersions API仅针对SharePoint的**文档集（Document Set）**类型有效，普通文件（如Word、PDF等）不支持该接口。如果你的列表项是普通文档，调用此API必然触发参数错误。
• 检查文档集版本控制配置：即使列表整体开了版本控制，还需单独为文档集内容类型启用版本控制。操作路径：SharePoint站点设置 → 网站内容类型 → 找到「文档集」内容类型 → 版本控制设置，确保勾选「为文档集启用版本控制」并完成相关配置。
• 验证API权限：确认应用已拥有Sites.Read.All或Sites.ReadWrite.All权限（按需选择），且权限已完成授权（管理员同意或用户授权）。
• 用REST API直接排查：先通过Graph Explorer发送REST请求测试：

  GET https://graph.microsoft.com/v1.0/sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions
  

  如果REST请求同样报错，说明问题出在资源配置或参数；如果REST请求成功，建议升级Microsoft Graph SDK到最新稳定版本，排查SDK本身的问题。

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