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 .
Mettez à jour les paramètres de confidentialité pour afficher ou retourner le type d’insights spécifié dans un organization. Les types de paramètres peuvent être des informations sur les contacts, des informations sur les éléments ou des informations sur les personnes.
Pour en savoir plus sur la personnalisation de la confidentialité des insights pour vos organization, consultez :
Les tableaux suivants indiquent l’autorisation ou les autorisations les moins privilégiées requises pour appeler cette API sur chaque type de ressource pris en charge. Suivez les bonnes pratiques pour demander des autorisations minimales. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Pour mettre à jour les paramètres d’informations sur les contacts pour une organization
Type d’autorisation
Autorisations avec privilèges minimum
Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)
Organization.ReadWrite.All
User.ReadWrite.All
Déléguée (compte Microsoft personnel)
Non prise en charge.
Non prise en charge.
Application
Non prise en charge.
Non prise en charge.
Pour mettre à jour les paramètres d’informations sur les éléments pour un organization
Type d’autorisation
Autorisations avec privilèges minimum
Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)
PeopleSettings.ReadWrite.All
Non disponible.
Déléguée (compte Microsoft personnel)
Non prise en charge.
Non prise en charge.
Application
PeopleSettings.ReadWrite.All
Non disponible.
Pour mettre à jour les paramètres d’insights de personnes pour un organization
Type d’autorisation
Autorisations avec privilèges minimum
Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)
Organization.ReadWrite.All
User.ReadWrite.All
Déléguée (compte Microsoft personnel)
Non prise en charge.
Non prise en charge.
Application
Non prise en charge.
Non prise en charge.
Note: L’utilisation d’autorisations déléguées pour cette opération afin de mettre à jour les insights pour les contacts, les éléments ou les personnes nécessite que l’utilisateur connecté dispose d’un rôle d’administrateur général.
Requête HTTP
Pour mettre à jour les paramètres des informations sur les contacts :
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés qui doivent être mises à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
Propriété
Type
Description
disabledForGroup
Chaîne
ID d’un groupe Microsoft Entra, dont le type d’insights spécifié est désactivé pour ses membres. La valeur par défaut est empty. Optional.
isEnabledInOrganization
Valeur booléenne
truesi le type d’insight spécifié est activé pour le organization ; false si le type d’insight spécifié est désactivé pour tous les utilisateurs sans exception. La valeur par défaut est true. Optional.
Note: Cette opération ne vérifie pas la valeur de la propriété disabledForGroup si vous l’incluez dans le corps de la demande. Si vous définissez la propriété disabledForGroup sur string, cette opération n’case activée pas l’existence du groupe de Microsoft Entra correspondant. Cela signifie que si vous définissez disabledForGroup sur un groupe Microsoft Entra qui n’existe pas ou qui est supprimé par la suite, cette opération ne sera pas en mesure d’identifier l’appartenance à un groupe et de désactiver les informations sur les éléments ou les personnes pour des utilisateurs spécifiques. Si isEnabledInOrganization est défini sur true, l’opération active le type d’insights spécifié pour tous les utilisateurs de la organization.
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet insightsSettings dans le corps de la réponse.
Exemples
Exemple 1 : Mettre à jour les paramètres pour les informations sur les contacts
Demande
L’exemple suivant montre comment un administrateur met à jour la propriété isEnabledInOrganization pour activer les informations de contact pour la organization spécifiée ; la valeur par défaut pour isEnabledInOrganization est false, désactivant les informations sur les contacts. L’exemple définit également le paramètre de confidentialité disabledForGroup pour interdire l’affichage des informations de contact de l’utilisateur dans un groupe de Microsoft Entra particulier.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new InsightsSettings
{
IsEnabledInOrganization = true,
DisabledForGroup = "edbfe4fb-ec70-4300-928f-dbb2ae86c981",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Organization["{organization-id}"].Settings.ContactInsights.PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta organization settings contact-insights patch --organization-id {organization-id} --body '{\
"isEnabledInOrganization": true,\
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
InsightsSettings insightsSettings = new InsightsSettings();
insightsSettings.setIsEnabledInOrganization(true);
insightsSettings.setDisabledForGroup("edbfe4fb-ec70-4300-928f-dbb2ae86c981");
InsightsSettings result = graphClient.organization().byOrganizationId("{organization-id}").settings().contactInsights().patch(insightsSettings);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\InsightsSettings;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new InsightsSettings();
$requestBody->setIsEnabledInOrganization(true);
$requestBody->setDisabledForGroup('edbfe4fb-ec70-4300-928f-dbb2ae86c981');
$result = $graphServiceClient->organization()->byOrganizationId('organization-id')->settings()->contactInsights()->patch($requestBody)->wait();
Exemple 2 : Mettre à jour les paramètres des insights sur les éléments
Demande
L’exemple suivant montre comment un administrateur met à jour le paramètre de confidentialité disabledForGroup afin d’interdire l’affichage des informations sur les éléments des utilisateurs d’un groupe Microsoft Entra particulier.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new InsightsSettings
{
DisabledForGroup = "edbfe4fb-ec70-4300-928f-dbb2ae86c981",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.People.ItemInsights.PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta admin people item-insights patch --body '{\
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
InsightsSettings insightsSettings = new InsightsSettings();
insightsSettings.setDisabledForGroup("edbfe4fb-ec70-4300-928f-dbb2ae86c981");
InsightsSettings result = graphClient.admin().people().itemInsights().patch(insightsSettings);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\InsightsSettings;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new InsightsSettings();
$requestBody->setDisabledForGroup('edbfe4fb-ec70-4300-928f-dbb2ae86c981');
$result = $graphServiceClient->admin()->people()->itemInsights()->patch($requestBody)->wait();
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}
Exemple 3 : Mettre à jour les paramètres des insights sur les contacts
Demande
L’exemple suivant montre comment un administrateur met à jour le paramètre de confidentialité disabledForGroup afin d’interdire l’affichage des informations sur les personnes des utilisateurs d’un groupe Microsoft Entra particulier.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new InsightsSettings
{
IsEnabledInOrganization = true,
DisabledForGroup = "edbfe4fb-ec70-4300-928f-dbb2ae86c981",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Organization["{organization-id}"].Settings.PeopleInsights.PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta organization settings people-insights patch --organization-id {organization-id} --body '{\
"isEnabledInOrganization": true,\
"disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
InsightsSettings insightsSettings = new InsightsSettings();
insightsSettings.setIsEnabledInOrganization(true);
insightsSettings.setDisabledForGroup("edbfe4fb-ec70-4300-928f-dbb2ae86c981");
InsightsSettings result = graphClient.organization().byOrganizationId("{organization-id}").settings().peopleInsights().patch(insightsSettings);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\InsightsSettings;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new InsightsSettings();
$requestBody->setIsEnabledInOrganization(true);
$requestBody->setDisabledForGroup('edbfe4fb-ec70-4300-928f-dbb2ae86c981');
$result = $graphServiceClient->organization()->byOrganizationId('organization-id')->settings()->peopleInsights()->patch($requestBody)->wait();
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.