tipo de recurso de presença

Artigo
05/24/2024

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 a atividade status 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 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.

Propriedades

Propriedade	Tipo	Descrição
atividade	Coleção de cadeias de caracteres	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	Coleção de cadeias de caracteres	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 presença status mensagem 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

Veja a seguir uma representação JSON do recurso.

{
   "activity": "String",
   "availability": "String",
   "id": "String (identifier)",
   "outOfOfficeSettings": {"@odata.type": "#microsoft.graph.outOfOfficeSettings"},
   "statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"}
}

Compartilhar via