Изменить

Получение сведений о присутствии

  • Статья
  • Чтение занимает 8 мин

Пространство имен: microsoft.graph

Важно!

API в версии /beta Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте выбор версии .

Получение сведений о присутствии пользователя.

Разрешения

Для вызова этих API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Presence.Read, Presence.Read.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение Не поддерживается.

HTTP-запросы

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

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательный.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код 200 OK отклика и объект присутствия в тексте отклика.

Примеры

Пример 1. Получение сведений о присутствии

В следующем примере показано, как получить собственные сведения о присутствии. Для этой операции требуется разрешение Presence.Read.

Запрос

GET https://graph.microsoft.com/beta/me/presence

Отклик

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

{  
  "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
  "availability": "Available",
  "activity": "Available",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  }
}

Пример 2. Получение сведений о присутствии другого пользователя

В следующем примере показано, как получить сведения о присутствии для другого пользователя. Для этой операции требуется разрешение Presence.Read.All.

Запрос

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

Отклик

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

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

Пример 3. Получение сведений о присутствии другого пользователя

В следующем примере показано, как получить сведения о присутствии для другого пользователя. Для этой операции требуется разрешение Presence.Read.All.

Запрос

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

Отклик

HTTP/1.1 200 OK

{
  "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
  "availability": "Away",
  "activity": "BeRightBack",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  }
}