Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Contiene información sobre la presencia de un usuario, incluida su disponibilidad y actividad de usuario.
Este recurso admite la suscripción a notificaciones de cambio.
Métodos
| Método | Tipo de valor devuelto | Description |
|---|---|---|
| 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 la sesión de presencia de una aplicación para un usuario. | |
| Presencia clara | Borre la 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. | |
| Establecimiento de la ubicación automática | Ninguno | Actualice la ubicación de trabajo automática de un usuario. |
| Establecimiento de la ubicación manual | Ninguno | Establezca la señal de ubicación de trabajo manual para un usuario. |
| Borrar ubicación automática | Ninguno | Borre la señal de ubicación de trabajo automática para un usuario. |
| Borrar ubicación | Ninguno | Borre las señales de ubicación de trabajo de un usuario, incluidas las capas manuales y automáticas de la fecha actual. |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| actividad | Cadena | Información complementaria de la disponibilidad de un usuario. Los valores posibles son available, away, beRightBack, busy, doNotDisturb, offline, , outOfOfficepresenceUnknown. |
| disponibilidad | Cadena | Información de presencia base para un usuario. Los valores posibles son available, away, beRightBack, busy, doNotDisturb, focusing, inACall, inAMeeting, offline, , presentingpresenceUnknown. |
| id | String | El identificador único del usuario. |
| outOfOfficeSettings | outOfOfficeSettings | Configuración fuera de la oficina para un usuario. |
| sequenceNumber | Cadena | Marca string ordenable lexicográficamente que representa la versión de un objeto de presencia . |
| statusMessage | presenceStatusMessage | Mensaje de estado de presencia de un usuario. |
| workLocation | userWorkLocation | Representa el estado de ubicación de trabajo agregado del usuario. |
Nota:
- Para obtener más información sobre los diferentes estados de presencia, consulte Presencia del usuario en Teams.
- Para obtener más información sobre las sesiones de presencia, las permutaciones de estados, los tiempos de espera y los dominios de confianza, consulte Administración del estado de presencia mediante microsoft Graph API.
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"},
"sequenceNumber": "String",
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"},
"workLocation": {"@odata.type": "microsoft.graph.userWorkLocation" }
}