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

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

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

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

Разрешения

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

HTTP-запрос

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

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

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

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

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

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

Отклик

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

Примеры

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

Запрос

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

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

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/users/5b649834-7412-4cce-9e69-176e95a394f5/teamwork/installedApps/NWI2NDk4MzQtNzQxMi00Y2NlLTllNjktMTc2ZTk1YTM5NGY1IyNhNmI2MzM2NS0zMWE0LTRmNDMtOTJlYy03MTBiNzE1NTdhZjk/upgrade')
	.post();

Отклик

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

HTTP/1.1 204 No Content

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

Чтобы получить список разрешений для конкретных ресурсов, необходимых приложению, получите приложение из 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"
      }
    ]
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const upgrade = {
  consentedPermissionSet: {
    resourceSpecificPermissions: [
      {
        permissionValue: 'TeamsActivity.Send.User',
        permissionType: 'Application'
      }
    ]
  }
};

await client.api('/users/5b649834-7412-4cce-9e69-176e95a394f5/teamwork/installedApps/NWI2NDk4MzQtNzQxMi00Y2NlLTllNjktMTc2ZTk1YTM5NGY1IyNhNmI2MzM2NS0zMWE0LTRmNDMtOTJlYy03MTBiNzE1NTdhZjk/upgrade')
	.post(upgrade);

Отклик

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

HTTP/1.1 204 No Content