Compartir a través de


tipo de recurso presence

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Contiene información sobre la presencia de un usuario, incluida su disponibilidad y actividad de usuario.

Nota: Este recurso solo se admite actualmente para los usuarios de Microsoft Teams.

Este recurso admite la suscripción a notificaciones de cambio.

Métodos

Método Tipo de valor devuelto Descripción
Obtener presencia presencia Obtener información de presencia de un usuario.
Obtener presencia para varios usuarios colección presence Obtenga la información de presencia de varios usuarios.
Establecer presencia Establezca el estado de disponibilidad y actividad en una sesión de presencia de una aplicación para un usuario.
Presencia clara Borrar una sesión de presencia de una aplicación para un usuario.
Establecer la presencia preferida por el usuario Establezca la disponibilidad y el estado de actividad preferidos para un usuario.
Borrar la presencia preferida del usuario Borre la disponibilidad y el estado de actividad preferidos para un usuario.
Establecer mensaje de estado de usuario Establezca un mensaje de estado de presencia para un usuario.

Propiedades

Propiedad Tipo Descripción
actividad Colección string Información complementaria de la disponibilidad de un usuario. Los valores posibles son Available, Away, BeRightBack, Busy, DoNotDisturb, InAConferenceCallInACall, , Inactive, InAMeeting, Offline, , OffWork, OutOfOffice, PresenceUnknown, , PresentingUrgentInterruptionsOnly.
disponibilidad Colección string Información de presencia base para un usuario. Los valores posibles son Available, AvailableIdle, Away, BeRightBack, Busy, BusyIdle, DoNotDisturb, , OfflinePresenceUnknown.
id String El identificador único del usuario.
outOfOfficeSettings outOfOfficeSettings Configuración fuera de la oficina para un usuario.
statusMessage presenceStatusMessage Mensaje de estado de presencia de un usuario.

Nota: Para obtener más información sobre los diferentes estados de presencia, consulte Presencia del usuario en Teams.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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