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
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.
Este recurso admite la suscripción a notificaciones de cambios.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Obtener presencia | presencia | Obtener la información de presencia de un usuario. |
| Obtener presencia para varios usuarios | Colección de presencia | Obtenga la información de presencia para varios usuarios. |
| Establecer presencia | Establecer el estado de disponibilidad y actividad de un usuario en una sesión de presencia de una aplicación. | |
| Presencia clara | Borre una sesión de presencia de una aplicación para un usuario. | |
| Establecer la presencia preferida del usuario | Establezca el estado de disponibilidad y actividad preferido para un usuario. | |
| Borrar la presencia preferida del usuario | Borrar el estado de disponibilidad y actividad preferido para un usuario. | |
| Establecer mensaje de estado de usuario | Establecer un mensaje de estado de presencia para un usuario. | |
| Establecer ubicación automática | Ninguno | Actualizar la ubicación de trabajo automática de un usuario. |
| Establecer 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 para un usuario, incluidas las capas manuales y automáticas para la fecha actual. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| actividad | Cadena | La información complementaria a la disponibilidad de un usuario. Los valores posibles son available, away, beRightBack, busy, doNotDisturboffline, , outOfOffice, , . presenceUnknown |
| disponibilidad | Cadena | La información de presencia base de un usuario. Los valores posibles son available, away, beRightBack, busyinAMeetingfocusingdoNotDisturbinACall, offline, , presenting, , . presenceUnknown |
| id | String | El identificador único del usuario. |
| outOfOfficeSettings | outOfOfficeSettings | La configuración fuera de la oficina para un usuario. |
| número de secuencia | Cadena | Marca de cadena ordenable lexicográficamente que representa la versión de un objeto de presencia . |
| statusMessage | presenceStatusMessage | El mensaje de estado de presencia de un usuario. |
| workLocation | userWorkLocation | Representa el estado de la ubicación de trabajo agregada del usuario. |
Nota:
- Para obtener más información sobre los distintos estados de presencia, consulte Presencia del usuario en Teams.
- Para obtener más información sobre las sesiones de presencia, los estados, las permutaciones, los tiempos de espera y los dominios de confianza, consulte Administrar el estado de presencia mediante la 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" }
}