Graph API添加SPFx列表ListItem：多值托管元数据字段格式疑问

算力阿峰

2026-6-15

多值托管元数据列的Graph API正确请求格式

针对SPFx列表的多值托管元数据列，使用Graph API创建ListItem时，正确的请求格式是将字段值设为对象数组，每个对象需指定@odata.type、TermGuid和Label属性，具体格式如下：

正确请求体示例

{
  "fields": {
    "{termColumnName}": [
      {
        "@odata.type": "#Microsoft.SharePoint.Taxonomy.TaxonomyFieldValue",
        "TermGuid": "{termGuid1}",
        "Label": "{termLabel1}"
      },
      {
        "@odata.type": "#Microsoft.SharePoint.Taxonomy.TaxonomyFieldValue",
        "TermGuid": "{termGuid2}",
        "Label": "{termLabel2}"
      }
    ]
  }
}

错误格式说明

数组字符串格式（400错误）：直接传递字符串数组不符合Graph API对托管元数据字段的结构要求，系统无法识别数组中的字符串为有效元数据项，因此返回400错误。
逗号分隔字符串格式（仅第二个值生效）：这种格式是SharePoint传统REST API的单值字段写法，当用逗号分隔多个项时，系统仅会解析最后一个有效元数据项，导致只有第二个值被填充。