Partilhar via


presença: setStatusMessage

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.

Defina uma mensagem de presença status para um usuário. Uma data e hora de validade opcionais podem ser fornecidas.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Presence.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Presence.ReadWrite.All Indisponível.

Solicitação HTTP

POST /users/{userId}/presence/setStatusMessage

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
statusMessage microsoft.graph.presenceStatusMessage Contém a presença status mensagem do usuário.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK.

Exemplos

Exemplo 1: Definir status mensagem com a data de validade

A solicitação a seguir define a presença status mensagem como "Ei, estou atualmente em uma reunião" para o usuário fa8bf3dc-eca7-46b7-bad1-db199b62afc3, com a expiração em 2022-10-18 at 17:05:33.2079781 Pacific Standard Time.

Solicitação

POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage
Content-Type: application/json

{
  "statusMessage": {
    "message": {
        "content": "Hey I'm currently in a meeting.",
        "contentType": "text"
    },
    "expiryDateTime": {
        "dateTime": "2022-10-18T17:05:33.2079781",
        "timeZone": "Pacific Standard Time"
    }
  }
}

Resposta

HTTP/1.1 200 OK

Exemplo 2: Definir status mensagem de outro usuário

A solicitação a seguir define a presença status mensagem como "Ei, estou disponível agora" para o usuário fa8bf3dc-eca7-46b7-bad1-db199b62afc3. No Exemplo 3, as informações de presença do usuário fa8bf3dc-eca7-46b7-bad1-db199b62afc3 são obtidas em nome de outro usuário por meio de uma solicitação getPresence .

Solicitação

POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage
Content-Type: application/json

{
  "statusMessage": {
    "message": {
      "content": "Hey I am available now",
      "contentType": "text"
    }
  }
}

Resposta

HTTP/1.1 200 OK

Exemplo 3: Obter outra presença de usuário

Este exemplo segue o Exemplo 2. As informações de presença do usuário fa8bf3dc-eca7-46b7-bad1-db199b62afc3 são obtidas em nome de outro usuário por meio de uma solicitação getPresence .

Solicitação

GET https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence

Resposta

Como essa solicitação obtém a presença status para outro usuário, as statusMessage.expiryDateTime propriedades e statusMessage.publishedDateTime não estão incluídas no corpo da resposta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
  "availability": "Available",
  "activity": "Available",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  },
  "statusMessage": {
    "message": {
      "content": "Hey I am available now",
      "contentType": "text"
    }
  }
}