storyline: follow

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

Важно!

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

Следуйте за сюжетной линией пользователя в организации.

В Viva Engage пользователи могут следовать за другими пользователями на платформе. Эта функция помогает пользователям оставаться в курсе действий и публикаций пользователей, на которые они подписаны. Это полезно для отслеживания влиятельных или ключевых лиц в организации, таких как руководители или послы, которые могут помочь распространять новости и осведомленность по конкретным темам.

Разрешения

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

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

HTTP-запрос

POST /users/{user-id}/employeeExperience/storyline/follow

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

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

В тексте запроса укажите представление параметров в формате JSON.

Для делегированных разрешений (контекст пользователя) оставьте текст запроса пустым:

{}

Для разрешений приложения (контекст только приложения) укажите следующий параметр:

Параметр Тип Описание
followBy engagementIdentitySet Сведения об удостоверении пользователя, который выполняет следующие действия. Требуется для разрешений приложения.

Отклик

В случае успешного выполнения это действие возвращает код отклика 204 No Content.

Примеры

Пример 1. Отслеживание пользователя с делегированными разрешениями

В следующем примере показано, как следовать за пользователем с помощью делегированных разрешений.

Запрос

POST https://graph.microsoft.com/beta/users/f2a84916-d735-41d9-a04a-4ecf6266ae71/employeeExperience/storyline/follow
Content-Type: application/json

{}

Отклик

HTTP/1.1 204 No Content

Пример 2. Отслеживание пользователя с разрешениями приложения

В следующем примере показано, как следовать за пользователем с помощью разрешений приложения.

Запрос

POST https://graph.microsoft.com/beta/users/b3c29da7-ff83-4a92-b14e-7c91fe830b96/employeeExperience/storyline/follow
Content-Type: application/json

{
  "followBy": {
    "user": {
      "id": "e7f439cd-2e84-4b15-a903-f6d82a7b9c21"
    }
  }
}

Отклик

HTTP/1.1 204 No Content