Partager via


Ajouter l’application à l’équipe

Espace de noms: microsoft.graph

Installez une application pour l’équipe spécifié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

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) TeamsAppInstallation.ReadWriteSelfForTeam1, TeamsAppInstallation.ReadWriteForTeam1, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam, Group.ReadWrite.All2, Directory.ReadWrite.All2
Déléguée (compte Microsoft personnel) Non prise en charge.
Application TeamsAppInstallation.ReadWriteSelfForTeam.All1, TeamsAppInstallation.ReadWriteForTeam.All1, TeamsAppInstallation.ReadWriteAndConsentForTeam.All, TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All, Group.ReadWrite.All2, Directory.ReadWrite.All2

Remarque :
1 Ces autorisations ne peuvent pas être utilisées pour installer des applications qui nécessitent un consentement pour des autorisations de consentement spécifiques à la ressource
2 Ces autorisations 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

POST /teams/{team-id}/installedApps

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

Le corps de la demande doit inclure l’ID d’application généré de l’application de catalogue. Pour plus d’informations, consultez propriétés teamsApp.

Le tableau suivant répertorie les propriétés supplémentaires qui peuvent être incluses dans le corps de la demande.

Propriété Type Description
teamsApp String ID de l’application à ajouter.
consentedPermissionSet teamsAppPermissionSet Ensemble d’autorisations spécifiques à la ressource qui sont consentées.

Remarque : les autorisations autorisées pendant l’installation doivent correspondre aux autorisations spécifiques à la ressource spécifiées dans teamsAppDefinition de l’application. Pour obtenir l’application et les autorisations spécifiques aux ressources déléguées, consultez l’exemple 6. Si seules les autorisations déléguées spécifiques aux ressources sont spécifiées dans teamsAppDefinition, les autorisations peuvent être omises dans le corps de la demande.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK. Il ne retourne rien dans le corps de la réponse.

Exemples

Exemple 1 : Installer une application dans une équipe

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/teams/87654321-0abc-zqf0-321456789q/installedApps
Content-type: application/json

{
   "teamsApp@odata.bind":"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 200 OK

Pour obtenir la liste des autorisations spécifiques à la ressource requises par l’application, obtenez l’application à partir d’appCatalog, comme illustré dans l’exemple 6.

Demande

POST https://graph.microsoft.com/v1.0/teams/7023576d-9e40-47ca-9cf2-daae6838e785/installedApps
Content-Type: application/json

{
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/7023576d-9e40-47ca-9cf2-daae6838e785",
    "consentedPermissionSet": {
        "resourceSpecificPermissions": [
        {
          "permissionValue": "OnlineMeeting.ReadBasic.Chat",
          "permissionType": "delegated"
        },
        {
          "permissionValue": "ChatMessage.Read.Chat",
          "permissionType": "application"
        }]
      }
}

Réponse

HTTP/1.1 201 Created

Si votre appel génère un message d’erreur indiquant The required permissions have not been consented to by the caller, le corps de la demande ne spécifie pas toutes les autorisations RSC requises par l’application pour laquelle l’utilisateur doit accorder son consentement. Veillez à générer votre demande comme indiqué dans l’exemple.