命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
根据数据保护策略异步处理一批内容条目。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | Content.Process.All | 不可用。 |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | Content.Process.All | 不可用。 |
HTTP 请求
POST /security/dataSecurityAndGovernance/processContentAsync
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | application/json. 必需。 |
请求正文
在请求正文中，提供具有以下参数的 JSON 对象。
| 参数 | 类型 | 说明 |
|---|---|---|
| processContentRequests | processContentBatchRequest 集合 | 必填。 单个内容处理请求的集合，每个请求都有自己的用户上下文、内容和请求 ID。 |
请求正文的大小限制为 2 MB。 每个请求的最大内容条目数为 64。 这些内容最多可分布在 64 个 processContentRequests 中，每个包含一个内容条目或 2 个 processContentRequests，每个包含 32 个内容条目或不超过 64 个内容条目的其他组合。
响应
在大多数情况下，如果成功，此方法将返回 204，无内容。 此方法还可以在响应正文中返回 200 OK 响应代码和 processContentResponses 对象的集合。 集合中的每个对象对应于批处理中的请求项之一（由 requestId标识），并包含该特定项 (策略作、错误、范围状态) 的结果。 鉴于这是一个异步 意向 API，从提交批处理的调用方的角度来看， 200 OK 指示批处理已接受;响应正文中的结果反映了服务处理每个项的结果。
示例
请求
以下示例显示了包含两个项的批处理请求。
POST https://graph.microsoft.com/beta/security/dataSecurityAndGovernance/processContentAsync
Content-type: application/json
{
"processContentRequests": [
{
"requestId": "bca22a4e-245f-4b6f-a242-9bdbc238e413",
"userId": "47b5e19a-e210-4ed5-a643-dbf5b47e1821",
"contentToProcess": {
"contentEntries": [
{
"@odata.type": "#microsoft.graph.processConversationMetadata",
"identifier": "47138e53-c855-47f0-9271-d473681ac310",
"content": {
"@odata.type": "#microsoft.graph.textContent",
"data": "1309475745, Is D3m0P@sswd! a secure password?"
},
"name": "Chat message",
"correlationId": "e76bcc34-07ea-43f4-ae64-d383df423b90",
"sequenceNumber": 0,
"createdDateTime": "2025-04-21T16:00:00Z",
"modifiedDateTime": "2025-04-21T16:00:00Z"
}
],
"activityMetadata": {
"activity": "uploadText",
},
"deviceMetadata": {
"operatingSystemSpecifications": {
"operatingSystemPlatform": "Windows",
"operatingSystemVersion": "10.0.19045"
},
"ipAddress": "127.0.0.1"
},
"protectedAppMetadata": {
"name": "PC Purview Workload",
"version": "0.2",
"applicationLocation":{
"@odata.type": "microsoft.graph.policyLocationApplication",
"value": "be121c8f-ecd8-4026-b699-669e0ce1bcbf"
}
},
"integratedAppMetadata": {
"name": "PCA Workload Sample - IA",
"version": "1.0"
}
}
},
{
"requestId": "f1df4929-4116-4ee6-b008-0a6a42037aed",
"userId": "47b5e19a-e210-4ed5-a643-dbf5b47e1821",
"contentToProcess": {
"contentEntries": [
{
"@odata.type": "#microsoft.graph.processConversationMetadata",
"identifier": "02be9bc1-335c-4184-ae4c-247449e5e85d",
"content": {
"@odata.type": "#microsoft.graph.textContent",
"data": "1309475746, The password D3m0P@sswd! has a mix of uppercase and lowercase letters, numbers, and special characters, which are good practices for creating a strong password. However, its length and the use of common patterns like 'Demo' and 'Password' can make it less secure than it appears."
},
"name": "Chat message",
"correlationId": "e76bcc34-07ea-43f4-ae64-d383df423b90",
"sequenceNumber": 1,
"createdDateTime": "2025-04-21T16:00:00Z",
"modifiedDateTime": "2025-04-21T16:00:00Z"
}
],
"activityMetadata": {
"activity": "downloadText",
},
"deviceMetadata": {
"operatingSystemSpecifications": {
"operatingSystemPlatform": "Windows",
"operatingSystemVersion": "10.0.19045"
},
"ipAddress": "127.0.0.1"
},
"protectedAppMetadata": {
"name": "PC Purview Workload",
"version": "0.2",
"applicationLocation":{
"@odata.type": "microsoft.graph.policyLocationApplication",
"value": "be19dc8f-ecd8-4026-b699-669e0ce1bcbf"
}
},
"integratedAppMetadata": {
"name": "PCA Workload Sample - IA",
"version": "1.0"
}
}
}
]
}
响应
以下示例显示了 204 无内容响应。
注意：为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 204 No Content