Listar aplicativos em equipe
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Recupere a lista de aplicativos instalados na equipe especificada.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
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.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | TeamsAppInstallation.ReadForTeam | TeamsAppInstallation.ReadWriteSelfForTeam, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteForTeam |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | TeamsAppInstallation.Read.Group | TeamsAppInstallation.ReadWriteSelfForTeam.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam.All, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All |
Observação
- As permissões Group.Read.All, Group.ReadWrite.All, Directory.Read.All e Directory.ReadWrite.All têm suporte apenas para compatibilidade com versões anteriores. Recomendamos que você atualize suas soluções para usar uma permissão alternativa e evite usar essas permissões daqui para frente.
- A permissão TeamsAppInstallation.Read.Group usa o consentimento específico do recurso.
Solicitação HTTP
GET /teams/{team-id}/installedApps
Parâmetros de consulta opcionais
Esse método dá suporte aos $filter
parâmetros de consulta , $select
e $expand
OData para ajudar a personalizar a resposta.
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.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta e uma 200 OK
coleção de objetos teamsAppInstallation no corpo da resposta.
Exemplos
Exemplo 1: Listar aplicativos instalados
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('6903fa93-605b-43ef-920e-77c4729f8258')/installedApps",
"@odata.count":3,
"value":[
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwMDAwMTAxNi1kZTA1LTQ5MmUtOTEwNi00ODI4ZmM4YTg2ODc="
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwYWUzNWIzNi0wZmQ3LTQyMmUtODA1Yi1kNTNhZjE1NzkwOTM="
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwZDgyMGVjZC1kZWYyLTQyOTctYWRhZC03ODA1NmNkZTdjNzg="
}
]
}
Exemplo 2: obter os nomes e outros detalhes dos aplicativos instalados
Solicitação
No exemplo a seguir, se uma instância de um aplicativo instalado tiver um bot associado a ele, os detalhes do bot também serão retornados.
GET https://graph.microsoft.com/beta/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps?$expand=teamsAppDefinition($expand=bot)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('6903fa93-605b-43ef-920e-77c4729f8258')/installedApps(teamsAppDefinition())",
"@odata.count":3,
"value":[
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwMDAwMTAxNi1kZTA1LTQ5MmUtOTEwNi00ODI4ZmM4YTg2ODc=",
"teamsAppDefinition":{
"id":"MDAwMDEwMTYtZGUwNS00OTJlLTkxMDYtNDgyOGZjOGE4Njg3IyMxLjAuMg==",
"teamsAppId":"00001016-de05-492e-9106-4828fc8a8687",
"azureADAppId":"7df0a125-d3be-4c96-aa54-591f83ff541c",
"displayName":"Power Automate Actions",
"version":"1.0.2",
"requiredResourceSpecificApplicationPermissions":[
],
"publishingState":"published",
"shortdescription":"Be more productive with Microsoft Flow",
"description":"Automate time-consuming and repetitive tasks by integrating your favorite apps and services with Microsoft Power Automate.",
"lastModifiedDateTime":null,
"createdBy":null,
"bot":{
"id":"9a58a3ec-6b68-4818-ac11-844f1c326784"
}
}
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwYWUzNWIzNi0wZmQ3LTQyMmUtODA1Yi1kNTNhZjE1NzkwOTM=",
"teamsAppDefinition":{
"id":"MGFlMzViMzYtMGZkNy00MjJlLTgwNWItZDUzYWYxNTc5MDkzIyMxLjI=",
"teamsAppId":"0ae35b36-0fd7-422e-805b-d53af1579093",
"azureADAppId":"00000003-0000-0ff1-ce00-000000000000",
"displayName":"SharePoint Pages",
"version":"1.2",
"requiredResourceSpecificApplicationPermissions":[
],
"publishingState":"published",
"shortdescription":"Add a tab for a SharePoint news article or page.",
"description":"This app allows you to tab intranet pages from any SharePoint site so that they can be viewed by your team inside Teams channels.",
"lastModifiedDateTime":null,
"createdBy":null
}
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwZDgyMGVjZC1kZWYyLTQyOTctYWRhZC03ODA1NmNkZTdjNzg=",
"teamsAppDefinition":{
"id":"MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==",
"teamsAppId":"0d820ecd-def2-4297-adad-78056cde7c78",
"azureADAppId":"2d4d3d8e-2be3-4bef-9f87-7875a61c29de",
"displayName":"OneNote",
"version":"1.0.0",
"requiredResourceSpecificApplicationPermissions":[
],
"publishingState":"published",
"shortdescription":"Capture and share ideas, to-do lists and other notes with your team.",
"description":"Capture and share ideas, to-do lists and other thoughts with your team. You can also co-author anytime.",
"lastModifiedDateTime":null,
"createdBy":null
}
}
]
}
Exemplo 3: obter o recurso de instalação do aplicativo com base na ID do manifesto do aplicativo associado
Solicitação
O exemplo a seguir mostra uma solicitação. No exemplo, a ID do manifesto do aplicativo teams é cf1ba4c7-f94e-4d80-ba90-5594b641a8ee
.
GET https://graph.microsoft.com/beta/teams/acda442c-78d2-491b-8204-4ef5019c0193/installedApps?$expand=teamsApp,teamsAppDefinition&$filter=teamsApp/externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'
Observação
Este exemplo se aplica a aplicativos sideload ou organizacionais. O valor externalId está vazio para aplicativos com um tipo distributionMethod de store
. Quando os aplicativos são publicados na loja global, a ID do aplicativo corresponde à ID no manifesto do aplicativo.
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.count":1,
"value":[
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwMjQwYTM2OC0yNWUwLTQ1NjktOGViZS0xMzYwMWNiNTVhMTg=",
"teamsApp":{
"id":"0240a368-25e0-4569-8ebe-13601cb55a18",
"externalId":"cf1ba4c7-f94e-4d80-ba90-5594b641a8ee",
"displayName":"YPA",
"distributionMethod":"sideloaded"
},
"teamsAppDefinition":{
"id":"MDI0MGEzNjgtMjVlMC00NTY5LThlYmUtMTM2MDFjYjU1YTE4IyM2LjAuMA==",
"teamsAppId":"0240a368-25e0-4569-8ebe-13601cb55a18",
"azureADAppId":"9fc97ea2-c417-4c76-a2db-197612067b28",
"displayName":"YPA",
"version":"6.0.0",
"requiredResourceSpecificApplicationPermissions":[
],
"publishingState":"published",
"shortdescription":"A conversational smart assistant from MSX that surfaces real-time insights.",
"description":"For MSX Users: A conversational role-based smart assistant that will enable Enterprise sellers (AE, ATS, SSP, TSP) to be more productive by surfacing real-time insights, recommendations, actions and notifications, and by automating repetitive tasks.",
"lastModifiedDateTime":null,
"createdBy":null
}
}
]
}
Exemplo 4: obter o conjunto de permissões específicas do recurso consentido para os aplicativos instalados na equipe especificada
O exemplo a seguir obtém a lista de todas as permissões específicas do recurso que foram concedidas a um aplicativo como parte da instalação. Um $select
parâmetro de consulta é necessário para mostrar o conjunto de permissões consentido.
Solicitação
GET https://graph.microsoft.com/beta/teams/7eeb5a95-f602-4861-ab67-49714fa5a020/installedApps?$select=consentedPermissionSet,id
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/teams('7eeb5a95-f602-4861-ab67-49714fa5a020')/installedApps(consentedPermissionSet,id)",
"@odata.count": 70,
"value": [
{
"id": "N2VlYjVhOTUtZjYwMi00ODYxLWFiNjctNDk3MTRmYTVhMDIwIyMwMDAwMTAxNi1kZTA1LTQ5MmUtOTEwNi00ODI4ZmM4YTg2ODc=",
"consentedPermissionSet": null
},
{
"id": "N2VlYjVhOTUtZjYwMi00ODYxLWFiNjctNDk3MTRmYTVhMDIwIyMxYzI1NmE2NS04M2E2LTRiNWMtOWNjZi03OGY4YWZiNmYxZTg=",
"consentedPermissionSet": {
"resourceSpecificPermissions": [
{
"permissionValue": "ChannelMeeting.ReadBasic.Group",
"permissionType": "delegated"
},
{
"permissionValue": "ChannelMeetingStage.Write.Group",
"permissionType": "delegated"
}
]
}
},
]
}
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de