presence: setUserPreferredPresence
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.
Establezca la disponibilidad y el estado de actividad preferidos para un usuario. Si se establece la presencia preferida de un usuario, la presencia del usuario es la presencia preferida.
La presencia preferida solo surte efecto cuando haya al menos una sesión de presencia del usuario. De lo contrario, la presencia del usuario permanece como sin conexión.
Se puede crear una sesión de presencia como resultado de una operación setPresence correcta o si el usuario ha iniciado sesión en un cliente de Teams.
Obtenga más información sobre las sesiones de presencia y su tiempo de espera y expiración.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | Presence.ReadWrite | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | Presence.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /users/{userId}/presence/setUserPreferredPresence
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
disponibilidad | string | Información de presencia base. |
actividad | string | Información complementaria a la disponibilidad. |
expirationDuration | duration | Expiración de la sesión de presencia de la aplicación. El valor se representa en formato ISO 8601 para las duraciones. Si no se proporciona, se aplicará una expiración predeterminada: DoNotDisturb o Busy: expira en 1 día Todos los demás: expiran en 7 días |
Las combinaciones admitidas de disponibilidad y actividad son:
disponibilidad | actividad | Descripción |
---|---|---|
Disponible | Disponible | Establezca la presencia preferida por el usuario como Disponible. |
Ocupado | Ocupado | Establezca la presencia preferida por el usuario como Ocupado. |
Donotdisturb | Donotdisturb | Establezca la presencia preferida por el usuario como DoNotDisturb. |
BeRightBack | BeRightBack | Establezca la presencia preferida del usuario como BeRightBack. |
Lejos | Lejos | Establezca la presencia preferida por el usuario como Ausente. |
Offline | OffWork | Establezca la presencia preferida por el usuario como Sin conexión. |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK
.
Ejemplos
La siguiente solicitud establece la presencia preferida por el usuario como DoNotDisturb para el usuario fa8bf3dc-eca7-46b7-bad1-db199b62afc3
, con la expiración de 8 horas.
Solicitud
POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setUserPreferredPresence
Content-Type: application/json
{
"availability": "DoNotDisturb",
"activity": "DoNotDisturb",
"expirationDuration": "PT8H"
}
Respuesta
HTTP/1.1 200 OK
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de