Compartir a través de


presence: clearAutomaticLocation

Espacio de nombres: microsoft.graph

Borre la señal de ubicación de trabajo automática para un usuario. Después de borrar, la ubicación de trabajo agregada final del usuario se vuelve a calcular según las reglas de precedencia:

  • Precedencia: programación automática > manual >
  • Si se establece una ubicación manual, borrar la señal automática no cambia la ubicación final porque la ubicación manual sigue teniendo prioridad.
  • Si no se establece ninguna ubicación manual, la ubicación final vuelve a la señal programada (horario de trabajo del calendario y ubicación – WHL) para el segmento actual o a ninguna si no hay ninguna señal programada.

Use esta operación cuando necesite quitar la señal detectada automáticamente actual sin afectar a las capas manuales o programadas.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Presence.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

POST /me/presence/clearAutomaticLocation

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, esta acción devuelve un código de respuesta 200 OK.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK