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 utilizador, incluindo a disponibilidade e a atividade do utilizador.
Este recurso suporta a subscrição de notificações de alteração.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter presença | presença | Obtenha as informações de presença de um utilizador. |
| Obter presença para vários utilizadores | coleção de presenças | Obtenha as informações de presença de vários utilizadores. |
| Definir presença | Defina a sessão de presença de uma aplicação para um utilizador. | |
| Limpar presença | Limpe a sessão de presença de uma aplicação para um utilizador. | |
| Definir a presença preferencial do utilizador | Defina a disponibilidade preferencial e a atividade status para um utilizador. | |
| Limpar a presença preferencial do utilizador | Limpe a disponibilidade preferencial e a atividade status para um utilizador. | |
| Definir mensagem de status de utilizador | Defina uma mensagem de status de presença para um utilizador. | |
| Definir a localização automática | Nenhum | Atualize a localização de trabalho automática de um utilizador. |
| Definir localização manual | Nenhum | Defina o sinal de localização de trabalho manual para um utilizador. |
| Limpar localização automática | Nenhum | Limpe o sinal de localização de trabalho automática para um utilizador. |
| Limpar localização | Nenhum | Limpe os sinais de localização de trabalho de um utilizador, incluindo as camadas manuais e automáticas da data atual. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| atividade | Cadeia de caracteres | As informações suplementares à disponibilidade de um utilizador. Os valores possíveis são available, away, beRightBack, busy, doNotDisturb, offline, , outOfOffice. presenceUnknown |
| availability | Cadeia de caracteres | As informações de presença base de um utilizador. Os valores possíveis são available, away, beRightBack, busy, doNotDisturb, focusing, inACall, inAMeeting, offline, , presenting, . presenceUnknown |
| id | String | O identificador exclusivo do usuário. |
| outOfOfficeSettings | outOfOfficeSettings | As definições de fora do escritório para um utilizador. |
| sequenceNumber | Cadeia de caracteres | O carimbo de Cadeia lexicograficamente ordenável que representa a versão de um objeto de presença . |
| statusMessage | presenceStatusMessage | A presença status mensagem de um utilizador. |
| workLocation | userWorkLocation | Representa o estado agregado da localização de trabalho do utilizador. |
Observação
- Para saber mais sobre os diferentes estados de presença, veja Presença de utilizadores no Teams.
- Para obter mais detalhes sobre sessões de presença, permutações de estados, tempos limite e domínios fidedignos, consulte Gerir o estado de presença com o microsoft API do Graph.
Relações
Nenhum
Representação JSON
A representação JSON seguinte 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" }
}