teamsAppInstallation в личных область: обновление

  • Статья

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

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

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

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого 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

HTTP-запрос

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

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

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

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

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

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

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

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

Отклик

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

Примеры

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

Запрос

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

POST https://graph.microsoft.com/v1.0/users/5b649834-7412-4cce-9e69-176e95a394f5/teamwork/installedApps/NWI2NDk4MzQtNzQxMi00Y2NlLTllNjktMTc2ZTk1YTM5NGY1IyNhNmI2MzM2NS0zMWE0LTRmNDMtOTJlYy03MTBiNzE1NTdhZjk/upgrade

Отклик

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

HTTP/1.1 204 No Content

Чтобы получить список разрешений для конкретных ресурсов, необходимых приложению, получите приложение из appCatalog. Дополнительные сведения см. в статье Перечисление приложений, установленных в личных область пользователя.

Запрос

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

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

{
  "consentedPermissionSet": {
    "resourceSpecificPermissions": [
      {
        "permissionValue": "TeamsActivity.Send.User",
        "permissionType": "Application"
      }
    ]
  }
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content