teamsAppInstallation no escopo pessoal: atualização

Namespace: microsoft.graph

Atualize uma instalação de aplicativo no escopo pessoal do usuário especificado para a versão mais recente do aplicativo.

Nota: Essa API funciona de forma diferente em uma ou mais nuvens nacionais. Para obter detalhes, confira Diferenças de implementação da API do Microsoft Teams em nuvens nacionais.

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação HTTP

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

Cabeçalhos de solicitação

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON das propriedades.

A tabela a seguir mostra as propriedades que podem ser usadas com esse método.

Nota: As permissões consentidas durante a instalação devem ser as mesmas que as permissões específicas do recurso presentes no teamsAppDefinition do aplicativo. Para obter o aplicativo e as permissões específicas do recurso delegadas, consulte Listar aplicativos instalados no escopo pessoal de um usuário. Se apenas as permissões delegadas específicas do recurso estiverem presentes no teamsAppDefinition, as permissões poderão ser omitidas do corpo da solicitação.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplos

Exemplo 1: atualizar um aplicativo específico instalado para um usuário

Solicitação

O exemplo a seguir mostra uma solicitação.

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();

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: atualizar um aplicativo específico instalado para um usuário e consentir com as permissões específicas do recurso

Para obter a lista de permissões específicas do recurso exigidas pelo aplicativo, obtenha o aplicativo do appCatalog. Para obter detalhes, confira Listar aplicativos instalados no escopo pessoal de um usuário.

Solicitação

O exemplo a seguir mostra uma solicitação.

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);

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content