présence : clearAutomaticLocation

Espace de noms: microsoft.graph

Importante

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 .

Effacez le signal automatique de l’emplacement de travail pour un utilisateur. Une fois l’effacement, l’emplacement de travail agrégé final de l’utilisateur est recalculé en fonction des règles de priorité :

  • Priorité : manuel, > automatique > , planifié
  • Si une position manuelle est définie, l’effacement du signal automatique ne modifie pas la position finale, car la position manuelle est toujours prioritaire.
  • Si aucun emplacement manuel n’est défini, l’emplacement final revient au signal programmé (heures de travail calendaires et emplacement – WHL) pour le segment en cours, ou à aucun s’il n’y a pas de signal programmé.

Utilisez cette opération lorsque vous devez supprimer le signal actuel détecté automatiquement sans affecter les couches manuelles ou programmées.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisation de moindre privilège Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Presence.ReadWrite Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

Requête HTTP

POST /me/presence/clearAutomaticLocation

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette action renvoie un code de réponse 200 OK. Elle ne renvoie rien dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/me/presence/clearAutomaticLocation

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 200 OK