如何通过Power Automate调用REST API配置JSON请求体以成功更新SharePoint文件元数据？

我来帮你捋捋这个场景下容易踩的坑，大概率是这几个环节出了问题：

1. 先确认REST API端点与请求头是否正确 #

更新文件元数据的标准API端点格式不能错，得对应上你的站点、文档库和文件路径：

_api/web/getfilebyserverrelativeurl('/sites/你的站点名/文档库名/目标文件名.ext')/listitemallfields

注意替换成你实际的路径，根站点可以去掉/sites/你的站点名部分。另外请求必须用POST方法，同时要在请求头里加这几个关键参数：

• X-HTTP-Method: MERGE（告诉SharePoint这是更新操作）
• IF-MATCH: *（忽略版本冲突，也可以填文件的ETag值做严格校验）
• Content-Type: application/json;odata=verbose（对应后续请求体的odata格式）

2. 重点检查请求体的JSON格式与字段内部名称 #

这是最容易翻车的地方！SharePoint不认字段的显示名称，必须用内部名称。比如你看到的“项目编号”，内部名称可能是Project_x0020_Number（空格会被转成_x0020_）。

怎么找内部名称？去SharePoint列表设置里点目标字段，看浏览器地址栏最后一段的Field=xxx，那个xxx就是内部名称。

正确的请求体格式（odata=verbose模式）示例：

{
  "__metadata": {
    "type": "SP.Data.文档库名称ListItem"
  },
  "内部字段名1": "要更新的值1",
  "内部字段名2": "要更新的值2"
}

注意SP.Data.文档库名称ListItem里的文档库名称也要用转义后的格式，比如“项目文档”要写成SP.Data.项目_x0020_文档ListItem。

如果用轻量的odata模式（odata=minimalmetadata），请求体可以简化成这样，同时要把请求头的Content-Type改成application/json;odata=minimalmetadata：

{
  "内部字段名1": "要更新的值1",
  "内部字段名2": "要更新的值2"
}

3. Power Automate里的配置细节别漏 #

• 确保“发送HTTP请求到SharePoint”动作里选的站点地址是正确的；
• 请求方法选POST后，一定要去“高级选项”里添加之前说的那几个请求头，别漏；
• 请求体里填JSON的时候，别加多余的引号或者转义错误，如果用动态变量（比如从其他步骤取的值），要正确用@{变量名}的格式插入。

4. 权限问题也不能忽略 #

试试用有文档库编辑权限的账号运行流，最好是站点管理员账号，先排除权限不足的问题。

5. 看错误日志找线索 #

如果还是失败，去Power Automate的运行历史里点开“发送HTTP请求”动作，看输出里的详细错误信息：

• 提示“字段不存在”？那肯定是用了显示名称而非内部名称；
• 提示“访问被拒绝”？检查账号权限；
• 提示“无效JSON”？检查请求体的逗号、引号有没有写错。

举个完整的示例：我要更新“项目文档”库中test.docx的ProjectID（内部名称）字段，请求体如下：

{
  "__metadata": {
    "type": "SP.Data.项目_x0020_文档ListItem"
  },
  "ProjectID": "PROJ-2024-001"
}

请求头设置：

• X-HTTP-Method: MERGE
• IF-MATCH: *
• Content-Type: application/json;odata=verbose
  API端点：_api/web/getfilebyserverrelativeurl('/sites/项目站点/项目文档/test.docx')/listitemallfields

按照这个步骤排查，应该能解决你的问题！

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