Liste des applications dans équipe
Espace de noms: microsoft.graph
Récupérez la liste des applications installées dans l’équipe spécifiée.
Remarque
La valeur id
de la ressource teamsAppInstallation n’est pas la même que celle id
de la ressource teamsApp associée.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | TeamsAppInstallation.ReadForTeam | TeamsAppInstallation.ReadWriteSelfForTeam, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam, TeamsAppInstallation.ReadWriteAndConsentForTeam, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, TeamsAppInstallation.ReadWriteForTeam |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | TeamsAppInstallation.Read.Group | TeamsAppInstallation.ReadWriteSelfForTeam.All, Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, TeamsAppInstallation.ManageSelectedForTeam.All, TeamsAppInstallation.Read.All, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All |
Remarque
Les autorisations Group.Read.All, Group.ReadWrite.All, Directory.Read.All et Directory.ReadWrite.All sont prises en charge uniquement pour la compatibilité descendante. Nous vous recommandons de mettre à jour vos solutions pour utiliser une autre autorisation et éviter d’utiliser ces autorisations à l’avenir.
Requête HTTP
GET /teams/{team-id}/installedApps
Paramètres facultatifs de la requête
Cette méthode prend en charge les $filter
paramètres de requête OData , $select
et $expand
pour vous aider à personnaliser la réponse.
En-têtes de demande
En-tête | Valeur |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse et une 200 OK
collection d’objets teamsAppInstallation dans le corps de la réponse.
Exemples
Exemple 1 : Répertorier les applications installées
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#teams('6903fa93-605b-43ef-920e-77c4729f8258')/installedApps",
"@odata.count":3,
"value":[
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwMDAwMTAxNi1kZTA1LTQ5MmUtOTEwNi00ODI4ZmM4YTg2ODc="
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwYWUzNWIzNi0wZmQ3LTQyMmUtODA1Yi1kNTNhZjE1NzkwOTM="
},
{
"id":"NjkwM2ZhOTMtNjA1Yi00M2VmLTkyMGUtNzdjNDcyOWY4MjU4IyMwZDgyMGVjZC1kZWYyLTQyOTctYWRhZC03ODA1NmNkZTdjNzg="
}
]
}
Exemple 2 : Obtenir les noms et autres détails des applications installées
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/teams/6903fa93-605b-43ef-920e-77c4729f8258/installedApps?$expand=teamsAppDefinition
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$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
}
},
{
"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
}
}
]
}
Exemple 3 : Obtenir la ressource d’installation d’application en fonction de l’ID de manifeste de l’application associée
Demande
L’exemple suivant illustre une demande. Dans l’exemple, l’ID de manifeste de l’application Teams est « cf1ba4c7-F94E-4d80-ba90-5594b641a8ee ».
GET https://graph.microsoft.com/v1.0/teams/acda442c-78d2-491b-8204-4ef5019c0193/installedApps?$expand=teamsApp,teamsAppDefinition&$filter=teamsApp/externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'
Remarque
Cet exemple s’applique aux applications d’organisation ou chargées de manière indépendante. La valeur externalId est vide pour les applications dont le type store
distributionMethod est . Lorsque des applications sont publiées dans le magasin global, l’ID de l’application correspond à l’ID dans le manifeste de l’application.
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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
}
}
]
}
Exemple 4 : Obtenir l’ensemble des autorisations spécifiques à la ressource autorisées pour les applications installées dans l’équipe spécifiée
L’exemple suivant obtient la liste des autorisations spécifiques à la ressource qui ont été accordées à une application dans le cadre de l’installation. Un $select
paramètre de requête est requis pour afficher le jeu d’autorisations consenti.
Demande
GET https://graph.microsoft.com/v1.0/teams/7eeb5a95-f602-4861-ab67-49714fa5a020/installedApps?$select=consentedPermissionSet,id
Réponse
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/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"
}
]
}
},
]
}