L’API de demande de droits de l’objet sous le /privacy nœud est déconseillée et cessera de retourner des données le 30 mars 2025. Utilisez le nouveau chemin d’accès sous /security.
POST /security/subjectRightsRequests
POST /privacy/subjectRightsRequests
Collection d’utilisateurs qui peuvent collaborer sur la demande.
contentQuery
Chaîne
Requête de contenu basée sur KQL qui doit être utilisée pour la recherche. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
Contient les propriétés de la personne concernée pour la requête.
dataSubjectType
dataSubjectType
Type de personne concernée. Les valeurs possibles sont les suivantes : customer, currentEmployee, formerEmployee, prospectiveEmployee, student, teacher, faculty, other, unknownFutureValue.
description
Chaîne
Description de la demande.
displayName
Chaîne
Nom de la demande.
externalId
Chaîne
ID externe de la requête immuable après sa création et utilisé pour le suivi de la demande pour le système externe. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
includeAllVersions
Valeur booléenne
Incluez toutes les versions des documents. Par défaut, les copies actuelles des documents sont retournées. Si le contrôle de version est activé sur les sites SharePoint, toutes les versions incluent automatiquement les copies historiques des documents. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
includeAuthoredContent
Valeur booléenne
Inclure le contenu créé par la personne concernée. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
internalDueDateTime
DateTimeOffset
Date d’échéance interne utilisée pour le suivi de l’achèvement de la demande.
Emplacements de boîte aux lettres qui doivent faire l’objet d’une recherche. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
pauseAfterEstimate
Valeur booléenne
Suspendez la requête une fois l’estimation terminée. Par défaut, l’estimation des données s’exécute, puis s’interrompt, ce qui vous permet d’afficher un aperçu des résultats, puis de sélectionner l’option permettant de récupérer des données dans l’interface utilisateur. Vous pouvez définir cette propriété sur false si vous souhaitez qu’elle effectue l’estimation, puis commence automatiquement par la récupération du contenu. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
Emplacements des sites SharePoint et OneDrive qui doivent faire l’objet d’une recherche. Cette propriété est définie uniquement pour les API accessibles à l’aide du chemin de requête \security et non du chemin de requête \privacy .
type
subjectRightsRequestType
Type de la demande. Les valeurs possibles sont les suivantes : export, access, delete, tagForAction, unknownFutureValue.
Réponse
Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet subjectRightsRequest dans le corps de la réponse.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new SubjectRightsRequest
{
Type = SubjectRightsRequestType.Export,
ContentQuery = "((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))",
DataSubjectType = DataSubjectType.Customer,
ExternalId = "F53BF2DA-607D-412A-B568-FAA0F023AC0B",
DisplayName = "Export report for customer Id: 12345",
Description = "This is a export request",
IncludeAllVersions = false,
IncludeAuthoredContent = true,
InternalDueDateTime = DateTimeOffset.Parse("2022-07-20T22:42:28Z"),
DataSubject = new DataSubject
{
FirstName = "Diego",
LastName = "Siciliani",
Email = "Diego.Siciliani@contoso.com",
Residency = "USA",
},
MailboxLocations = null,
PauseAfterEstimate = true,
Regulations = new List<string>
{
"CCPA",
},
SiteLocations = new SubjectRightsRequestAllSiteLocation
{
OdataType = "microsoft.graph.subjectRightsRequestAllSiteLocation",
},
Approvers = new List<User>
{
new User
{
Id = "1B761ED2-AA7E-4D82-9CF5-C09D737B6167",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Privacy.SubjectRightsRequests.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SubjectRightsRequest subjectRightsRequest = new SubjectRightsRequest();
subjectRightsRequest.setType(SubjectRightsRequestType.Export);
subjectRightsRequest.setContentQuery("((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))");
subjectRightsRequest.setDataSubjectType(DataSubjectType.Customer);
subjectRightsRequest.setExternalId("F53BF2DA-607D-412A-B568-FAA0F023AC0B");
subjectRightsRequest.setDisplayName("Export report for customer Id: 12345");
subjectRightsRequest.setDescription("This is a export request");
subjectRightsRequest.setIncludeAllVersions(false);
subjectRightsRequest.setIncludeAuthoredContent(true);
OffsetDateTime internalDueDateTime = OffsetDateTime.parse("2022-07-20T22:42:28Z");
subjectRightsRequest.setInternalDueDateTime(internalDueDateTime);
DataSubject dataSubject = new DataSubject();
dataSubject.setFirstName("Diego");
dataSubject.setLastName("Siciliani");
dataSubject.setEmail("Diego.Siciliani@contoso.com");
dataSubject.setResidency("USA");
subjectRightsRequest.setDataSubject(dataSubject);
subjectRightsRequest.setMailboxLocations(null);
subjectRightsRequest.setPauseAfterEstimate(true);
LinkedList<String> regulations = new LinkedList<String>();
regulations.add("CCPA");
subjectRightsRequest.setRegulations(regulations);
SubjectRightsRequestAllSiteLocation siteLocations = new SubjectRightsRequestAllSiteLocation();
siteLocations.setOdataType("microsoft.graph.subjectRightsRequestAllSiteLocation");
subjectRightsRequest.setSiteLocations(siteLocations);
LinkedList<User> approvers = new LinkedList<User>();
User user = new User();
user.setId("1B761ED2-AA7E-4D82-9CF5-C09D737B6167");
approvers.add(user);
subjectRightsRequest.setApprovers(approvers);
SubjectRightsRequest result = graphClient.privacy().subjectRightsRequests().post(subjectRightsRequest);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\SubjectRightsRequest;
use Microsoft\Graph\Generated\Models\SubjectRightsRequestType;
use Microsoft\Graph\Generated\Models\DataSubjectType;
use Microsoft\Graph\Generated\Models\DataSubject;
use Microsoft\Graph\Generated\Models\SubjectRightsRequestAllSiteLocation;
use Microsoft\Graph\Generated\Models\User;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new SubjectRightsRequest();
$requestBody->setType(new SubjectRightsRequestType('export'));
$requestBody->setContentQuery('((\"Diego Siciliani\" OR \"Diego.Siciliani@contoso.com\") OR (participants:\"Diego.Siciliani@contoso.com\"))');
$requestBody->setDataSubjectType(new DataSubjectType('customer'));
$requestBody->setExternalId('F53BF2DA-607D-412A-B568-FAA0F023AC0B');
$requestBody->setDisplayName('Export report for customer Id: 12345');
$requestBody->setDescription('This is a export request');
$requestBody->setIncludeAllVersions(false);
$requestBody->setIncludeAuthoredContent(true);
$requestBody->setInternalDueDateTime(new \DateTime('2022-07-20T22:42:28Z'));
$dataSubject = new DataSubject();
$dataSubject->setFirstName('Diego');
$dataSubject->setLastName('Siciliani');
$dataSubject->setEmail('Diego.Siciliani@contoso.com');
$dataSubject->setResidency('USA');
$requestBody->setDataSubject($dataSubject);
$requestBody->setMailboxLocations(null);
$requestBody->setPauseAfterEstimate(true);
$requestBody->setRegulations(['CCPA', ]);
$siteLocations = new SubjectRightsRequestAllSiteLocation();
$siteLocations->setOdataType('microsoft.graph.subjectRightsRequestAllSiteLocation');
$requestBody->setSiteLocations($siteLocations);
$approversUser1 = new User();
$approversUser1->setId('1B761ED2-AA7E-4D82-9CF5-C09D737B6167');
$approversArray []= $approversUser1;
$requestBody->setApprovers($approversArray);
$result = $graphServiceClient->privacy()->subjectRightsRequests()->post($requestBody)->wait();