tenantDataSecurityAndGovernance: processContentAsync

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Procese un lote de entradas de contenido de todo el inquilino de forma asincrónica en las directivas de protección de datos.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	❌	❌	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Content.Process.All	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Content.Process.All	No disponible.

Solicitud HTTP

POST /security/dataSecurityAndGovernance/processContentAsync

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Parámetro	Tipo	Descripción
processContentRequests	colección processContentBatchRequest	Obligatorio. Colección de solicitudes de procesamiento de contenido individuales, cada una con su propio contexto de usuario, contenido e identificador de solicitud.

El tamaño del texto de cada entrada de contenido está limitado a 2 MB. El número máximo de entradas de contenido por solicitud es 64. Se pueden distribuir entre hasta 64 processContentRequests, cada uno de los cuales contiene una entrada de contenido o 2 processContentRequests, cada una con 32 entradas de contenido u otra combinación que no supera las 64 entradas de contenido.

Respuesta

En la mayoría de los casos, cuando se realiza correctamente, este método devuelve un valor 204, Sin contenido. Este método también puede devolver un 200 OK código de respuesta y una colección de objetos processContentResponses en el cuerpo de la respuesta. Cada objeto de la colección corresponde a uno de los elementos de solicitud del lote, identificado por y requestIdcontiene los resultados (acciones de directiva, errores, estado de ámbito) para ese elemento específico. Dado que se trata de una API de intención asincrónica desde la perspectiva del autor de la llamada que envía el lote, 200 OK indica que se aceptó el lote; los resultados dentro del cuerpo de la respuesta reflejan el resultado del procesamiento de cada elemento por el servicio.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra una solicitud por lotes con dos elementos.

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"
         }
      }
     }
   ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta 204 Sin contenido.

HTTP/1.1 204 No Content