Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Contém informações sobre a presença de um usuário, incluindo sua disponibilidade e atividade do usuário.
Este recurso suporta a assinatura de notificações de alteração.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter presença | presença | Obter informações de presença de um usuário. |
| Obter presença para vários usuários | Coleção Presence | Obtenha as informações de presença de vários usuários. |
| Definir presença | Defina a sessão de presença de um aplicativo para um usuário. | |
| Presença clara | Limpar a sessão de presença de um aplicativo para um usuário. | |
| Definir presença preferencial do usuário | Defina o status preferencial de disponibilidade e atividade para um usuário. | |
| Limpar presença preferencial do usuário | Desmarque o status preferencial de disponibilidade e atividade de um usuário. | |
| Definir mensagem de status do usuário | Defina uma mensagem de status de presença para um usuário. | |
| Definir localização automática | Nenhum | Atualize o local de trabalho automático de um usuário. |
| Definir local manual | Nenhum | Defina o sinal de local de trabalho manual para um usuário. |
| Limpar localização automática | Nenhum | Desmarque o sinal de local de trabalho automático para um usuário. |
| Limpar localização | Nenhum | Limpe os sinais de local de trabalho para um usuário, incluindo as camadas manual e automática para a data atual. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| atividade | Cadeia de caracteres | As informações complementares à disponibilidade de um usuário. Os valores possíveis são available, away, beRightBack, busydoNotDisturb, , offline, outOfOffice, , . presenceUnknown |
| availability | Cadeia de caracteres | As informações de presença básicas de um usuário. Os valores possíveis são available, away, beRightBack, busy, doNotDisturbinAMeetinginACallofflinefocusing, . presenceUnknownpresenting |
| id | String | O identificador exclusivo do usuário. |
| outOfOfficeSettings | outOfOfficeSettings | As configurações de ausência temporária de um usuário. |
| número de sequência | Cadeia de caracteres | O carimbo String classificável lexicograficamente que representa a versão de um objeto de presença . |
| statusMessage | presenceStatusMessage | A mensagem de status de presença de um usuário. |
| workLocation | userWorkLocation | Representa o estado de local de trabalho agregado do usuário. |
Observação
- Para saber mais sobre os diferentes estados de presença, consulte Presença do usuário no Teams.
- Para obter mais detalhes sobre sessões de presença, permutações de estados, tempos limite e domínios confiáveis, consulte Gerenciar o estado de presença usando a API do Graph.
Relações
Nenhum
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"activity": "String",
"availability":"String",
"id": "String (identifier)",
"outOfOfficeSettings": {"@odata.type": "#microsoft.graph.outOfOfficeSettings"},
"sequenceNumber": "String",
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"},
"workLocation": {"@odata.type": "microsoft.graph.userWorkLocation" }
}