Freigeben über


presence: clearAutomaticLocation

Namespace: microsoft.graph

Löschen Sie das automatische Arbeitsortsignal für einen Benutzer. Nach dem Löschen wird der endgültige aggregierte Arbeitsort des Benutzers gemäß den Rangfolgeregeln neu berechnet:

  • Rangfolge: manuell > automatisch > geplant
  • Wenn eine manuelle Position festgelegt ist, ändert das Löschen des automatischen Signals nicht die endgültige Position, da die manuelle Position weiterhin Vorrang hat.
  • Wenn kein manueller Standort festgelegt ist, wird der endgültige Standort auf das geplante Signal (Kalenderarbeitszeit und Standort – WHL) für das aktuelle Segment oder auf keine zurückgesetzt, wenn kein geplantes Signal vorhanden ist.

Verwenden Sie diesen Vorgang, wenn Sie das aktuelle automatisch erkannte Signal entfernen müssen, ohne dass sich dies auf manuelle oder geplante Ebenen auswirkt.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

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

HTTP-Anforderung

POST /me/presence/clearAutomaticLocation

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/me/presence/clearAutomaticLocation

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK