Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Excluir um aplicativo do catálogo de aplicativos de uma organização (o catálogo de aplicativos do locatário). Para excluir um aplicativo, a propriedade distributionMethod do aplicativo deve ser definida como organization.
Você também pode usar essa API para remover um aplicativo enviado do processo de revisão.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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.
O- Somente administradores de serviços do Teams ou uma função privilegiada superior podem chamar essa API.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Sem suporte. | Sem suporte. |
Observação
- A permissão Directory.ReadWrite.All tem suporte apenas para compatibilidade com versões anteriores. Recomendamos que você atualize suas soluções para usar uma permissão alternativa listada na tabela anterior e evite usar essas permissões daqui para frente.
- Você só pode usar a permissão AppCatalog.Submit para excluir definições de aplicativo na revisão.
Solicitação HTTP
Para excluir um aplicativo do catálogo de aplicativos:
DELETE /appCatalogs/teamsApps/{id}
Para excluir um aplicativo enviado, mas que ainda não foi aprovado:
DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Observação: Use a ID retornada da chamada List published apps para fazer referência ao aplicativo que você deseja excluir. Não use a ID do manifesto do pacote do aplicativo zip.
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.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
DELETE https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Conteúdo relacionado
Limites de limitação específicos do serviço do Microsoft Graph