Compartir a través de


presence: setStatusMessage

Espacio de nombres: microsoft.graph

Establezca un mensaje de estado de presencia para un usuario. Se puede proporcionar una fecha y hora de expiración opcionales.

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/setStatusMessage

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
statusMessage microsoft.graph.presenceStatusMessage Contiene el mensaje de estado de presencia del usuario.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK.

Ejemplos

Ejemplo 1: Establecer el mensaje de estado con la fecha de expiración

La siguiente solicitud establece el mensaje de estado de presencia como "Hey I'm currently in a meeting." para el usuario fa8bf3dc-eca7-46b7-bad1-db199b62afc3, con la expiración en 2022-10-18 at 17:05:33.2079781 Pacific Standard Time.

Solicitud

POST https://graph.microsoft.com/v1.0/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage
Content-Type: application/json

{
  "statusMessage": {
    "message": {
        "content": "Hey I'm currently in a meeting.",
        "contentType": "text"
    },
    "expiryDateTime": {
        "dateTime": "2022-10-18T17:05:33.2079781",
        "timeZone": "Pacific Standard Time"
    }
  }
}

Respuesta

HTTP/1.1 200 OK

Ejemplo 2: Establecer el mensaje de estado de otro usuario

La siguiente solicitud establece el mensaje de estado de presencia como "Hey I am available now" para el usuario fa8bf3dc-eca7-46b7-bad1-db199b62afc3. En el ejemplo 3, la información de presencia del usuario fa8bf3dc-eca7-46b7-bad1-db199b62afc3 se obtiene en nombre de otro usuario a través de una solicitud getPresence .

Solicitud

POST https://graph.microsoft.com/v1.0/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setStatusMessage
Content-Type: application/json

{
  "statusMessage": {
    "message": {
      "content": "Hey I am available now",
      "contentType": "text"
    }
  }
}

Respuesta

HTTP/1.1 200 OK

Ejemplo 3: Obtener otra presencia de usuario

En este ejemplo se sigue el ejemplo 2. La información de presencia del usuario fa8bf3dc-eca7-46b7-bad1-db199b62afc3 se obtiene en nombre de otro usuario a través de una solicitud getPresence .

Solicitud

GET https://graph.microsoft.com/v1.0/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence

Respuesta

Dado que esta solicitud obtiene el estado de presencia de otro usuario, las statusMessage.expiryDateTime propiedades y statusMessage.publishedDateTime no se incluyen en el cuerpo de la respuesta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
  "availability": "Available",
  "activity": "Available",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  },
  "statusMessage": {
    "message": {
      "content": "Hey I am available now",
      "contentType": "text"
    }
  }
}