Aktualisieren von InsightsSettings

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren Sie die Datenschutzeinstellungen, um den angegebenen Typ von Erkenntnissen in einem organization anzuzeigen oder zurückzugeben. Der Einstellungstyp kann Kontakteinblicke, Elementerkenntnisse oder Personenerkenntnisse sein.

Weitere Informationen zum Anpassen des Datenschutzes von Insights für Ihre organization finden Sie unter:

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

In den folgenden Tabellen sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

So aktualisieren Sie kontakterkenntnisse einstellungen für eine organization

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Organization.ReadWrite.All User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Nicht unterstützt Nicht unterstützt

So aktualisieren Sie Die Einstellungen für Elementerkenntnisse für eine organization

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) PeopleSettings.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung PeopleSettings.ReadWrite.All Nicht verfügbar.

So aktualisieren Sie die Einstellungen für Personeneinblicke für eine organization

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Organization.ReadWrite.All User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Nicht unterstützt Nicht unterstützt

Hinweis: Wenn Sie delegierte Berechtigungen für diesen Vorgang verwenden, um Erkenntnisse für Kontakte, Elemente oder Personen zu aktualisieren, muss der angemeldete Benutzer über die Rolle "Globaler Administrator" verfügen.

HTTP-Anforderung

So aktualisieren Sie Einstellungen für Kontakterkenntnisse:

PATCH /organization/{organizationId}/settings/contactInsights

So aktualisieren Sie Einstellungen für Elementerkenntnisse:

PATCH /admin/people/itemInsights

So aktualisieren Sie Einstellungen für Personenerkenntnisse:

PATCH /organization/{organizationId}/settings/peopleInsights

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
disabledForGroup String Die ID einer Microsoft Entra Gruppe, deren angegebene Art von Erkenntnissen für ihre Mitglieder deaktiviert ist. Der Standardwert ist empty. Optional.
isEnabledInOrganization Boolesch true, wenn der angegebene Erkenntnistyp für die organization aktiviert ist; false , wenn der angegebene Erkenntnistyp für alle Benutzer ohne Ausnahmen deaktiviert ist. Der Standardwert ist true. Optional.

Hinweis: Dieser Vorgang überprüft den Wert der eigenschaft disabledForGroup nicht, wenn Sie ihn in den Anforderungstext einschließen. Wenn Sie die eigenschaft disabledForGroup auf string festlegen, überprüft dieser Vorgang nicht, ob die entsprechende Microsoft Entra Gruppe vorhanden ist. Das bedeutet: Wenn Sie disabledForGroup auf eine Microsoft Entra Gruppe festlegen, die nicht vorhanden ist oder später gelöscht wird, kann dieser Vorgang keine Gruppenmitgliedschaft identifizieren und Keine Element- oder Personenerkenntnisse für bestimmte Benutzer deaktivieren. Wenn isEnabledInOrganization auf truefestgelegt ist, aktiviert der Vorgang den angegebenen Typ von Erkenntnissen für alle Benutzer im organization.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein insightsSettings-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren der Einstellungen für Kontakterkenntnisse

Anforderung

Das folgende Beispiel zeigt, wie ein Administrator die eigenschaft isEnabledInOrganization aktualisiert, um Kontakterkenntnisse für die angegebene organization zu aktivieren. Der Standardwert für isEnabledInOrganization ist , sodass Contact Insights deaktiviert wirdfalse. Im Beispiel wird auch die Datenschutzeinstellung disabledForGroup so festgelegt, dass die Anzeige der Kontakteinblicke eines Benutzers in einer bestimmten Microsoft Entra Gruppe verhindert wird.

PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/contactInsights
Content-type: application/json

{
  "isEnabledInOrganization": true,
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "isEnabledInOrganization": true,
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Beispiel 2: Aktualisieren der Einstellungen für Elementerkenntnisse

Anforderung

Das folgende Beispiel zeigt, wie ein Administrator die Datenschutzeinstellung disabledForGroup aktualisiert, um die Anzeige von Elementerkenntnissen von Benutzern in einer bestimmten Microsoft Entra Gruppe zu verhindern.

PATCH https://graph.microsoft.com/beta/admin/people/itemInsights
Content-type: application/json

{
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Beispiel 3: Aktualisieren von Einstellungen für Personenerkenntnisse

Anforderung

Das folgende Beispiel zeigt, wie ein Administrator die Datenschutzeinstellung disabledForGroup aktualisiert, um die Anzeige von Personeneinblicken von Benutzern in einer bestimmten Microsoft Entra Gruppe zu verhindern.

PATCH https://graph.microsoft.com/beta/organization/{organizationId}/settings/peopleInsights
Content-type: application/json

{
  "isEnabledInOrganization": true,
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "isEnabledInOrganization": true,
  "disabledForGroup": "edbfe4fb-ec70-4300-928f-dbb2ae86c981"
}