Partilhar via

workPlanOccurrence: setCurrentLocation

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize a sua localização de trabalho para o dia atual ou segmento ativo atual. Esta ação permite-lhe atualizar rapidamente a sua localização de trabalho sem modificar ocorrências individuais.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Calendars.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /me/settings/workHoursAndLocations/occurrences/setCurrentLocation

Observação

Chamar o ponto de extremidade /me exige um usuário conectado e, portanto, uma permissão delegada. As permissões de aplicação não são suportadas ao utilizar o /me ponto final.

Ao utilizar o /users/{id} ponto final, o ID tem de ser o seu próprio ID de utilizador.

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
placeId Cadeia de caracteres Identificador de um local da API de Diretório de Places do Microsoft Graph. Aplicável apenas quando workLocationType está definido como office.
updateScope workLocationUpdateScope O âmbito da atualização. Suporta um subconjunto dos valores de workLocationUpdateScope. Os valores possíveis são: currentSegment, currentDay.
workLocationType workLocationType O novo tipo de localização de trabalho a definir. Suporta um subconjunto dos valores de workLocationType. Os valores possíveis são: office, remote.

valores workLocationUpdateScope

Member Descrição
currentSegment Atualize apenas o segmento de hora atual.
currentDay Atualize todo o dia atual.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

Resposta

Se tiver êxito, esta ação retornará um código de resposta 204 No Content.

Exemplos

Exemplo 1: Definir a localização atual para o office

O exemplo seguinte mostra como definir a localização atual para o office.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Definir a localização atual como remota

O exemplo seguinte mostra como definir a localização atual como remota.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on