Einstellungen aktualisieren

Namespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften des userSettings-Objekts . Benutzer in derselben Organisation können basierend auf ihrer Einstellung oder den Organisationsrichtlinien unterschiedliche Einstellungen haben. Informationen zum Abrufen der aktuellen Einstellungen des Benutzers finden Sie unter den aktuellen Benutzereinstellungen.

Batchanforderung

Es ist auch möglich, mehrere Benutzer von Delve abzumelden und ihren Beitrag zur Inhaltsrelevanz für die gesamte Organisation über eine Batchanforderung zu deaktivieren. Weitere Informationen finden Sie unter JSON-Batchverarbeitung.

Wichtig: Nur Mitglieder der Rollengruppe "Organisationsverwaltung " können mehrere Benutzer aktualisieren.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	User.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	User.ReadWrite.All

HTTP-Anforderung

PATCH /me/settings

Anforderung mit einer "Benutzer-ID" oder "UserPrincipalName" sind nur für den Benutzer oder für einen Benutzer mit den Berechtigungen User.ReadWrite.All verfügbar. Weitere Informationen finden Sie unter Berechtigungen.

PATCH /users/{id | userPrincipalName}/settings/

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.

Eigenschaft	Typ	Beschreibung
contributionToContentDiscoveryDisabled	Boolesch	Auf "true" festgelegt, deaktivieren Sie den Stellvertretungszugriff auf die Trending-API und deaktivieren Sie den Zugriff auf Dokumente in Office Delve für den Benutzer. Die Einstellung auf "true" wirkt sich auch auf die Relevanz der in Microsoft 365 angezeigten Inhalte aus. Beispielsweise zeigen vorgeschlagene Websites in SharePoint Home und die Ansicht "Entdecken" in OneDrive for Business weniger relevante Ergebnisse an. Diese Einstellung spiegelt den Steuerelementstatus in Office Delve wider.

Beispiel

Anforderung

Hier ist eine Beispielanforderung, wie Sie einen Benutzer aus Delve abmelden und seinen Beitrag zur Inhaltsrelevanz für die gesamte Organisation deaktivieren können.

PATCH https://graph.microsoft.com/v1.0/me/settings
Content-type: application/json

{
  "contributionToContentDiscoveryDisabled": true
}

Antwort

Hier ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

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

{
  "contributionToContentDiscoveryAsOrganizationDisabled": false,
  "contributionToContentDiscoveryDisabled": true
}