tipo de recurso de presença
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.
Contém informações sobre a presença de um utilizador, incluindo a disponibilidade e a atividade do utilizador.
Nota: Atualmente, este recurso só é suportado para utilizadores do Microsoft Teams.
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 disponibilidade e o estado da atividade numa sessão de presença de uma aplicação para um utilizador. | |
| Limpar presença | Limpar uma sessão de presença de uma aplicação para um utilizador. | |
| Definir a presença preferencial do utilizador | Defina a disponibilidade preferencial e o estado da atividade de um utilizador. | |
| Limpar a presença preferencial do utilizador | Limpe a disponibilidade preferencial e o estado da atividade de um utilizador. | |
| Definir mensagem de estado do utilizador | Defina uma mensagem de estado de presença para um utilizador. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| atividade | String collection | As informações suplementares à disponibilidade de um utilizador. Os valores possíveis são Available, , AwayBeRightBack, Busy, DoNotDisturb, InACall, InAConferenceCall, Inactive, InAMeeting, Offline, OffWork, , OutOfOffice, , PresenceUnknown, . UrgentInterruptionsOnlyPresenting |
| availability | String collection | As informações de presença base de um utilizador. Os valores possíveis são Available, AvailableIdle, Away, BeRightBack, Busy, BusyIdle, DoNotDisturb, , Offline, . PresenceUnknown |
| id | String | O identificador exclusivo do usuário. |
| outOfOfficeSettings | outOfOfficeSettings | As definições de fora do escritório para um utilizador. |
| statusMessage | presenceStatusMessage | A mensagem de estado de presença de um utilizador. |
Nota: Para saber mais sobre os diferentes estados de presença, veja Presença de utilizadores no Teams.
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"},
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"}
}