Partilhar via

tipo de recurso de presença

  • Artigo

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"}
}