Partager via

workPlanOccurrence : setCurrentLocation

Espace de noms: microsoft.graph

Mettez à jour votre emplacement de travail pour le jour actuel ou le segment actif actuel. Cette action vous permet de mettre à jour rapidement votre emplacement de travail sans modifier les occurrences individuelles.

Autorisations

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

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Calendars.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/settings/workHoursAndLocations/occurrences/setCurrentLocation

Remarque

L’appel du point de terminaison /me nécessite un utilisateur connecté et par conséquent une autorisation déléguée. Les autorisations d’application ne sont pas prises en charge lors de l’utilisation du point de /me terminaison.

Lorsque vous utilisez le point de /users/{id} terminaison, l’ID doit être votre propre ID d’utilisateur.

POST /users/{id | userPrincipalName}/settings/workHoursAndLocations/occurrences/setCurrentLocation

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
placeId String Identificateur d’un emplacement à partir de l’API Répertoire Places Microsoft Graph. Applicable uniquement lorsque workLocationType a la valeur office.
updateScope workLocationUpdateScope Étendue de la mise à jour. Prend en charge un sous-ensemble des valeurs de workLocationUpdateScope. Les valeurs possibles sont : currentSegment, currentDay.
workLocationType workLocationType Nouveau type d’emplacement de travail à définir. Prend en charge un sous-ensemble des valeurs de workLocationType. Les valeurs possibles sont : office, remote.

Valeurs workLocationUpdateScope

Member Description
currentSegment Mettez à jour uniquement le segment de temps actuel.
currentDay Mettez à jour l’intégralité de la journée en cours.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Réponse

Si elle réussit, cette action renvoie un code de réponse 204 No Content.

Exemples

Exemple 1 : Définir l’emplacement actuel sur le bureau

L’exemple suivant montre comment définir l’emplacement actuel sur bureau.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/me/settings/workHoursAndLocations/occurrences/setCurrentLocation
Content-type: application/json

{
  "updateScope": "currentDay",
  "workLocationType": "office",
  "placeId": "12345678-1234-1234-1234-123456789012"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

Exemple 2 : définir l’emplacement actuel sur distant

L’exemple suivant montre comment définir l’emplacement actuel sur distant.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/me/settings/workHoursAndLocations/occurrences/setCurrentLocation
Content-type: application/json

{
  "updateScope": "currentSegment",
  "workLocationType": "remote"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content
  • Last updated on