tenantDataSecurityAndGovernance : processContentAsync

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Traiter un lot d’entrées de contenu à l’échelle du client de manière asynchrone par rapport aux stratégies de protection des données.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Content.Process.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Content.Process.All Non disponible.

Requête HTTP

POST /security/dataSecurityAndGovernance/processContentAsync

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.
client-request-id Chaîne (GUID recommandé). Facultatif. Identificateur unique de cette requête, qui est utilisé pour le suivi et le débogage dans les journaux et les interactions de support. Si aucun ID n’est fourni, il se peut qu’il soit généré automatiquement. Nous vous recommandons de spécifier l’ID pour faciliter le suivi et le débogage. Le même ID que celui envoyé dans la demande sera renvoyé dans la réponse.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
processContentRequests processContentBatchRequest collection Obligatoire. Collection de demandes de traitement de contenu individuelles, chacune avec son propre contexte utilisateur, son propre contenu et son propre ID de demande.

La taille du texte de chaque entrée de contenu est limitée à 2 Mo. Le nombre maximal d’entrées de contenu par demande est de 64. Celles-ci peuvent être réparties sur un maximum de 64 processContentRequests, chacune contenant une entrée de contenu ou 2 processContentRequests, chacune contenant 32 entrées de contenu ou une autre combinaison qui ne dépasse pas 64 entrées de contenu.

Réponse

Dans la plupart des cas, en cas de succès, cette méthode retourne une valeur 204, Aucun contenu. Cette méthode peut également retourner un 200 OK code de réponse et une collection d’objets processContentResponses dans le corps de la réponse. Chaque objet de la collection correspond à l’un des éléments de demande dans le lot, identifié par le requestIdet contient les résultats (actions de stratégie, erreurs, état de l’étendue) pour cet élément spécifique. Étant donné qu’il s’agit d’une API d’intention asynchrone du point de vue de l’appelant soumettant le lot, le 200 OK indique que le lot a été accepté ; les résultats dans le corps de la réponse reflètent le résultat du traitement de chaque élément par le service.

Exemple

Demande

L’exemple suivant illustre une demande de traitement par lots avec deux éléments.

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",
                "contentCategory": "ai"
            }
         ],
         "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"
         }
      }
     }
   ]
}

Réponse

L’exemple suivant montre la réponse 204 Aucun contenu.

HTTP/1.1 204 No Content
  • Dernière mise à jour :