userDataSecurityAndGovernance: processContent

命名空间:microsoft.graph

根据当前或指定用户上下文中的数据保护策略处理 内容 。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Content.Process.User Content.Process.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 Content.Process.User Content.Process.All

HTTP 请求

POST /me/dataSecurityAndGovernance/processContent

注意

调用 /me 终结点需要已登录的用户,因此需要委派权限。 使用 /me 终结点时,不支持应用程序权限。

POST /users/{userId}/dataSecurityAndGovernance/processContent

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
If-None-Match 可选。 API 使用此值来确定自上次调用 API 以来策略状态是否已更改。 该值来自从 protectionScopes 计算返回的 Etag 标头。 如果新计算的 Etag 值与此标头中传递的值不匹配,则返回的 protectionScopeState 属性将被“修改”,并且应用需要通过调用 protectionScopes 计算来刷新。
客户端请求 ID 建议) (GUID 字符串。 可选。 此请求的唯一标识符,用于在日志和支持交互中跟踪和调试。 如果未提供 ID,系统可能会自动生成一个 ID。 建议指定 ID 以简化跟踪和调试。 将在响应中返回请求中发送的相同 ID。

请求正文

在请求正文中,提供参数的 JSON 表示形式。

下表列出了调用此操作时所需的参数。

参数 类型 说明
contentToProcess processContentRequest 必填。 包含要为指定用户评估的内容条目和元数据 (活动、设备、应用程序) 的对象。

对于文件内容,请在 contentEntries 中使用 processFileMetadata 条目。 若要提供敏感度标签元数据,请将其继承的 sensitivityLabels 集合与一个或多个 currentLabel 对象一起包含在内。 即使仅提供一个标签,也请使用数组。 提供此元数据不会应用或更改文件上的标签。

如果不提供调用方提供的标签元数据,请省略 sensitivityLabels 或提供空集合。 这两种情况都不会从内容中删除标签。

仅为此 API 支持的活动提供标签元数据。 为不受支持的活动断言标签的请求可能会被拒绝。 架构继承不会建立活动支持。

响应

如果成功,此操作将在响应正文中返回 200 OK 响应代码和 processContentResponse ,或者 202 Accepted, 204 No Content 没有响应正文。

响应标头

名称 说明
ETag 可用于检测配置的策略状态是否已更改的指示器。 如果策略状态更改,则 ETag 值将更改,返回的 protectionScopeState 属性将被“修改”,应用需要通过调用 protectionScopes 计算来刷新。

示例

示例 1:企业应用

请求

以下示例演示来自企业应用的请求,该请求可以是非 AI 应用或 AI 应用。 发送时使用的 data 文本可以是应用中的任何文本 - 例如,文档正文、聊天消息或用户提示(如果应用是 AI 应用)。

POST https://graph.microsoft.com/v1.0/me/dataSecurityAndGovernance/processContent
Content-Type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
    "contentToProcess": {
       "contentEntries": [
          {
             "@odata.type": "microsoft.graph.processConversationMetadata",
             "identifier": "07785517-9081-4fe7-a9dc-85bcdf5e9075",
             "content": {
                "@odata.type": "microsoft.graph.textContent", 
                "data": "Write an acceptance letter for Alex Wilber with Credit card number 4532667785213500, ssn: 120-98-1437 at One Microsoft Way, Redmond, WA 98052"
             },
             "name":"PC Purview API Explorer message",
             "correlationId": "d63eafd2-e3a9-4c1a-b726-a2e9b9d9580d",
             "sequenceNumber": 0, 
             "isTruncated": false,
             "createdDateTime": "2025-05-27T17:23:20",
             "modifiedDateTime": "2025-05-27T17:23:20"
          }
       ],
       "activityMetadata": { 
          "activity": "uploadText"
       },
       "deviceMetadata": {
          "deviceType": "Unmanaged",
          "operatingSystemSpecifications": {
             "operatingSystemPlatform": "Windows 11",
             "operatingSystemVersion": "10.0.26100.0" 
          },
          "ipAddress": "127.0.0.1"
       },
       "protectedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.2",
          "applicationLocation":{
             "@odata.type": "microsoft.graph.policyLocationApplication",
             "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
          }
       },
       "integratedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.2" 
       }
    }
}

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json
Client-Request-Id: 50dc805c-3af4-42d9-ad16-a746235cc736

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "notModified",
  "policyActions": [],
  "processingErrors": []
}

示例 2:AI 智能体

请求

以下示例显示从 AI 代理发送的请求。 请注意,在请求中有一个 agents 类型的 aiAgentInfo数组。 在本例中, data 用于发送用户的提示。

POST https://graph.microsoft.com/v1.0/users/5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba/dataSecurityAndGovernance/processContent
Content-Type: application/json

{
    "contentToProcess": {
      "contentEntries": [
        {
          "@odata.type": "microsoft.graph.processConversationMetadata",
          "identifier": "42837765-85c9-4a28-a165-27b6aaa5f635",
          "content": {
            "@odata.type": "microsoft.graph.textContent",
            "data": "For application 123456789, Write an acceptance letter for Alex Wilber with Credit card number 0000111122223333, ssn: 000-11-2222 at One Microsoft Way, Redmond, WA 98052"
          },
          "agents": [
            {
              "@odata.type": "microsoft.graph.aiAgentInfo",
              "blueprintId": "c84571c6-5ef3-4af7-aed2-0491cfd362a0",
              "identifier": "89515a70-a236-43be-b977-3ff0b454f853",
              "name": "Demo Agent",
              "version": "1.0"
            }
          ],
          "name":"PC Purview API Explorer message",
          "correlationId": "1cd5e33a-c78f-46e4-a242-74b0ef910486",
          "sequenceNumber": 0,
             "isTruncated": false,
             "createdDateTime": "2026-04-08T20:52:08",
             "modifiedDateTime": "2026-04-08T20:52:08"
          }
       ],
       "activityMetadata": { 
          "activity": "uploadText"
       },
       "deviceMetadata": {
          "operatingSystemSpecifications": {
             "operatingSystemPlatform": "Windows 11",
             "operatingSystemVersion": "10.0.26200.0" 
          },
          "ipAddress": "127.0.0.1"
       },
       "protectedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.2",
          "applicationLocation":{
             "@odata.type": "microsoft.graph.policyLocationApplication",
             "value": "83ef198a-0396-4893-9d4f-d36efbffc8bd"
          }
       },
       "integratedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.1" 
       }
    }
}


响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "modified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}

示例 3:网络提供商应用

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/users/5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba/dataSecurityAndGovernance/processContent
Content-Type: application/json

{
	"contentToProcess": {
		"contentEntries": [
			{
				"@odata.type": "#microsoft.graph.processConversationMetadata",
				"identifier": "f7af180f-dc2e-467c-9719-757e1c61eabf",
				"content": {
					"@odata.type": "#microsoft.graph.textContent",
					"data": "some data"
				},
				"correlationId": "d63eafd2-e3a9-4c1a-b726-a2e9b9d95811",
				"sequenceNumber": 0,
				"name": "Test Content"
			}
		],
		"activityMetadata": {
			"activity": "uploadText"
		},
		"deviceMetadata": {
			"deviceType": "unmanaged",
			"ipAddress": null,
			"operatingSystemSpecifications": {
				"operatingSystemPlatform": "Windows",
				"operatingSystemVersion": "11.1"
			}
		},
		"integratedAppMetadata": {
			"name": "My Entra App",
			"version": "0.1"
		},
		"protectedAppMetadata": {
			"name": "My Entra App",
			"version": "0.1",
			"applicationLocation": {
				"@odata.type": "#microsoft.graph.policyLocationUrl",
				"value": "https://gemini.google.com"
			}
		}
	}
}


响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "modified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}

示例 4:包含文件内容的网络提供商应用

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/users/5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba/dataSecurityAndGovernance/processContent
Content-Type: application/json

{
	"contentToProcess": {
		"contentEntries": [
			{
				"@odata.type": "#microsoft.graph.processFileMetadata",
				"identifier": "f7af180f-dc2e-467c-9719-757e1c61eabf",
				"content": {
				"@odata.type": "#microsoft.graph.textContent",
					"data": "Base64 encoded content"
				},
				"name": "Test File.docx",
				"correlationId": "d63eafd2-e3a9-4c1a-b726-a2e9b9d95822",
				"createdDateTime": "2024-07-23T01:31:40.2020463Z",
				"modifiedDateTime": "2024-09-17T13:45:21.0000000Z",
				"correlationId": "9d84223c-521c-42f4-8f35-3cdeabe515d3",
				"length": 17352,
				"isTruncated": false,
				"ownerId": "ffe1ca70-6e5b-4120-abf0-472034ba05d4",
				"customProperties": {
					"Department": "Finance",
					"ReviewerName": "John Smith"
				}
			}
		],
		"activityMetadata": {
			"activity": "uploadFile"
		},
		"deviceMetadata": {
			"deviceType": "unmanaged",
			"operatingSystemSpecifications": {
				"operatingSystemPlatform": "Windows",
				"operatingSystemVersion": "11.1"
			}
		},
		"integratedAppMetadata": {
			"name": "Network Proxy App",
			"version": "1.0.0"
		},
		"protectedAppMetadata": {
			"name": "My App",
			"version": "0.1",
			"applicationLocation": {
				"@odata.type": "#microsoft.graph.policyLocationUrl",
				"value": "https://gemini.google.com"
			}
		}
	}
}

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "modified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}

示例 5:具有一个敏感度标签的文件内容

请求

以下示例为文件内容条目提供一个敏感度标签元数据对象。 sensitivityLabels 属性是一个集合,因此单个对象包含在数组中。 此示例中的标识符和标签值是虚构的。

POST https://graph.microsoft.com/v1.0/users/5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba/dataSecurityAndGovernance/processContent
Content-Type: application/json

{
  "contentToProcess": {
    "contentEntries": [
      {
        "@odata.type": "#microsoft.graph.processFileMetadata",
        "identifier": "project-proposal",
        "content": {
          "@odata.type": "#microsoft.graph.textContent",
          "data": "Draft project proposal."
        },
        "name": "Project proposal.docx",
        "isTruncated": false,
        "createdDateTime": "2026-10-01T09:00:00Z",
        "modifiedDateTime": "2026-10-01T09:00:00Z",
        "ownerId": "5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba",
        "sensitivityLabels": [
          {
            "id": "f7c86e4a-e462-4bbb-a0f0-078c10aa2898",
            "applicationMode": "manual"
          }
        ]
      }
    ],
    "activityMetadata": {
      "activity": "uploadFile"
    },
    "deviceMetadata": {
      "deviceType": "managed",
      "operatingSystemSpecifications": {
        "operatingSystemPlatform": "Windows 11",
        "operatingSystemVersion": "10.0.26100.0"
      }
    },
    "integratedAppMetadata": {
      "name": "Microsoft 365 Copilot",
      "version": "1.0.0"
    },
    "protectedAppMetadata": {
      "name": "Microsoft 365 Copilot in Word",
      "version": "1.0.0",
      "applicationLocation": {
        "@odata.type": "#microsoft.graph.policyLocationApplication",
        "value": "Copilot.M365.Word"
      }
    }
  }
}

响应

以下示例显示了当适用的数据保护策略要求阻止提交的内容时的响应。 返回的操作取决于适用的策略,而不是提供的标签数量。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "notModified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}

示例 6:具有两个敏感度标签的文件内容

请求

以下示例为同一文件内容条目提供了两个不同的敏感度标签元数据对象。 这两个对象都位于继承的 sensitivityLabels 集合中 ;每个都有自己的标签标识符和应用程序模式。 该集合描述调用方提供的元数据,并且不会对文件应用多个标签。

POST https://graph.microsoft.com/v1.0/users/5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba/dataSecurityAndGovernance/processContent
Content-Type: application/json

{
  "contentToProcess": {
    "contentEntries": [
      {
        "@odata.type": "#microsoft.graph.processFileMetadata",
        "identifier": "project-proposal",
        "content": {
          "@odata.type": "#microsoft.graph.textContent",
          "data": "Draft project proposal."
        },
        "name": "Project proposal.docx",
        "isTruncated": false,
        "createdDateTime": "2026-10-01T09:00:00Z",
        "modifiedDateTime": "2026-10-01T09:00:00Z",
        "ownerId": "5def8f26-aff8-4db6-a08c-0fcf8f1aa2ba",
        "sensitivityLabels": [
          {
            "id": "8d14c2db-3e52-4345-af62-4ee3e65bff9e",
            "applicationMode": "automatic"
          },
          {
            "id": "f7c86e4a-e462-4bbb-a0f0-078c10aa2898",
            "applicationMode": "manual"
          }
        ]
      }
    ],
    "activityMetadata": {
      "activity": "uploadFile"
    },
    "deviceMetadata": {
      "deviceType": "managed",
      "operatingSystemSpecifications": {
        "operatingSystemPlatform": "Windows 11",
        "operatingSystemVersion": "10.0.26100.0"
      }
    },
    "integratedAppMetadata": {
      "name": "Microsoft 365 Copilot",
      "version": "1.0.0"
    },
    "protectedAppMetadata": {
      "name": "Microsoft 365 Copilot in Word",
      "version": "1.0.0",
      "applicationLocation": {
        "@odata.type": "#microsoft.graph.policyLocationApplication",
        "value": "Copilot.M365.Word"
      }
    }
  }
}

响应

以下示例显示了当适用的数据保护策略要求阻止提交的内容时的响应。 提供两个标签本身并不决定响应。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.processContentResponse",
  "protectionScopeState": "notModified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}