如何使用Microsoft Graph正确更新SharePoint列表项多选字段？

你碰到的这个问题很常见：虽然GET请求返回的SharePoint多选字段是直接的字符串数组，但更新时必须使用嵌套的Value结构，这就是导致400错误的核心原因。

正确的PATCH请求体格式 #

针对你的CAG_x0020_Process_x0020_Status字段，正确的JSON请求体应该是这样的：

{
  "CAG_x0020_Process_x0020_Status": {
    "Value": [ 
      "Proposed Funding - Customer Billed", 
      "Proposed Funding - Sales Funded", 
      "SOW - Needed" 
    ]
  }
}

为什么GET和PATCH格式不同？ #

Microsoft Graph在返回多选字段数据时做了简化处理，直接返回选项数组；但在更新操作中，需要明确告知服务这是SharePoint特殊的多选Choice字段的值集合，所以必须用Value属性来包裹选项数组。这种设计是为了区分普通的数组类型字段和SharePoint的多选字段。

额外验证小贴士 #

• 确保你的PATCH请求头包含Content-Type: application/json，这是很多人容易忽略的点
• 确认数组里的选项文本和SharePoint列表中定义的选项完全一致（包括大小写、空格、特殊符号，一点都不能错）
• 如果需要清空该多选字段，直接传空数组即可：

  {
    "CAG_x0020_Process_x0020_Status": { "Value": [] }
  }
  

按照这个格式修改后，你的PATCH请求应该就能正常更新这个多选字段了，不会再出现400错误，顺利推进应用发布。

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