Поделиться через


Установка приложения для пользователя

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

Установите приложение в личном область указанного пользователя.

Примечание: Этот API работает по-разному в одном или нескольких национальных облаках. Дополнительные сведения см. в статье Различия в реализации API Microsoft Teams в национальных облаках.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) TeamsAppInstallation.ReadWriteSelfForUser TeamsAppInstallation.ManageSelectedForUser, TeamsAppInstallation.ReadWriteAndConsentForUser, TeamsAppInstallation.ReadWriteAndConsentSelfForUser, TeamsAppInstallation.ReadWriteForUser, TeamsAppInstallation.ReadWriteSelectedForUser
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение TeamsAppInstallation.ReadWriteSelfForUser.All TeamsAppInstallation.ManageSelectedForUser.All, TeamsAppInstallation.ReadWriteAndConsentForUser.All, TeamsAppInstallation.ReadWriteAndConsentSelfForUser.All, TeamsAppInstallation.ReadWriteForUser.All, TeamsAppInstallation.ReadWriteSelectedForUser.All

Примечание.

Если вы хотите установить, получить, обновить или удалить приложение для пользователя, необходимо использовать TeamsAppInstallation.ReadWriteForUser это разрешение.

HTTP-запрос

POST /users/{user-id | user-principal-name}/teamwork/installedApps

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

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

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

Текст запроса должен содержать созданный в каталоге идентификатор приложения для каталога приложений. Дополнительные сведения см. в разделе Свойства teamsApp. В следующей таблице перечислены дополнительные параметры, которые можно использовать с текстом запроса.

Параметр Тип Описание
consentedPermissionSet teamsAppPermissionSet Набор разрешений для конкретных ресурсов, на которые предоставляется согласие.

Примечание: Разрешения, на которые было предоставлено согласие во время установки, должны совпадать с разрешениями для конкретных ресурсов, представленными в teamsAppDefinition приложения. Чтобы получить разрешения для приложения и делегированных ресурсов, см. статью Список приложений, установленных в личной область пользователя. Если в teamsAppDefinition присутствуют только делегированные разрешения для конкретного ресурса, разрешения можно опустить в тексте этого запроса.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created. Он не возвращает ничего в теле ответа.

Примеры

Пример 1. Установка приложения для пользователя

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/users/5b649834-7412-4cce-9e69-176e95a394f5/teamwork/installedApps
Content-type: application/json

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 201 Created

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/users/5b649834-7412-4cce-9e69-176e95a394f5/teamwork/installedApps
Content-Type: application/json

{
  "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a",
  "consentedPermissionSet": {
    "resourceSpecificPermissions": [
      {
        "permissionValue": "TeamsActivity.Send.User",
        "permissionType": "Application"
      }
    ]
  }
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 201 Created

Ограничения регулирования для служб, связанных с Microsoft Graph