Compartir a través de


Obtener presencia

Espacio de nombres: microsoft.graph

Obtener información de presencia de un usuario.

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.Read Presence.Read.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Presence.Read.All Presence.ReadWrite.All

Nota:

  • No puede usar permisos de aplicación para acceder a las API en la ruta de /me acceso.
  • La tasa máxima de solicitudes para esta API es de 1500 solicitudes de API en un período de 30 segundos, por aplicación por inquilino.

Solicitud HTTP

GET /users/{id}/presence
GET /communications/presences
GET /me/presence

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto de presencia en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Obtener su propia información de presencia

En el ejemplo siguiente se muestra cómo obtener su propia información de presencia. Esta operación requiere el permiso Presence.Read.

Solicitud

GET https://graph.microsoft.com/v1.0/me/presence

Respuesta

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

{
	"id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
	"availability": "Available",
	"activity": "Available"
}

Ejemplo 2: Obtener la información de presencia de otro usuario

En el ejemplo siguiente se muestra cómo obtener la información de presencia de otro usuario. Esta operación requiere el permiso Presence.Read.All.

Solicitud

GET https://graph.microsoft.com/v1.0/users/66825e03-7ef5-42da-9069-724602c31f6b/presence

Respuesta

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

{
	"id": "66825e03-7ef5-42da-9069-724602c31f6b",
	"availability": "DoNotDisturb",
	"activity": "Presenting"
}

Ejemplo 3: Obtener la información de presencia de otro usuario

En el ejemplo siguiente se muestra cómo obtener la información de presencia de otro usuario. Esta operación requiere el permiso Presence.Read.All.

Solicitud

GET https://graph.microsoft.com/v1.0/communications/presences/dc74d9bb-6afe-433d-8eaa-e39d80d3a647

Respuesta

HTTP/1.1 200 OK

{
    "value": [
        {
            "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
            "availability": "Away",
            "activity": "BeRightBack"
        }
    ]
}