|
| 1 | +--- |
| 2 | +page_type: sample |
| 3 | +products: |
| 4 | +- office-teams |
| 5 | +- ms-graph |
| 6 | +languages: |
| 7 | +- csharp |
| 8 | +extensions: |
| 9 | + contentType: samples |
| 10 | + technologies: |
| 11 | + - Microsoft Graph |
| 12 | + services: |
| 13 | + - Microsoft Teams |
| 14 | + createdDate: 5/30/2017 6:00:04 PM |
| 15 | +--- |
| 16 | +# Exemples de l’API Microsoft Teams Graph |
| 17 | + |
| 18 | +Cet exemple contient des exemples d’appels vers de nombreuses API Teams Graph, notamment : |
| 19 | + |
| 20 | +* Obtenir mes équipes |
| 21 | +* Obtenir des canaux |
| 22 | +* Obtenir des applications |
| 23 | +* Créer un canal |
| 24 | +* Envoyer un message |
| 25 | +* Créer une équipe et un groupe |
| 26 | +* Ajouter une équipe au groupe |
| 27 | +* Ajouter un membre à l’équipe |
| 28 | +* Mettre à jour les paramètres d’une équipe |
| 29 | + |
| 30 | +## Exemples connexes |
| 31 | + |
| 32 | +* [Exemple de Contoso Airlines pour Microsoft Teams](https://github.com/microsoftgraph/contoso-airlines-teams-sample) |
| 33 | +* [Version du nœud des exemples de l’API Microsoft Teams Graph](https://github.com/OfficeDev/microsoft-teams-sample-graph/tree/master/Node/SampleApp) |
| 34 | + |
| 35 | +> Pour plus d’informations sur le développement d’applications pour Microsoft Teams, veuillez consulter la [documentation des développeurs](https://msdn.microsoft.com/en-us/microsoft-teams/index) de Microsoft Teams.\** |
| 36 | +
|
| 37 | +## Conditions préalables |
| 38 | + |
| 39 | +### Compte O365 avec des privilèges d’administrateur |
| 40 | + |
| 41 | +Pour configurer cette application, vous devez être administrateur global, car seuls les administrateurs globaux peuvent donner leur consentement pour des applications à l’aide d’autorisations telles que Group.ReadWrite.All. Envisagez de créer votre propre client de test en créant un compte de développeur avec notre [programme Office 365 Développeur](https://dev.office.com/devprogram). |
| 42 | + |
| 43 | +### Application inscrite |
| 44 | + |
| 45 | +Vous devez enregistrer une application en procédant comme suit : |
| 46 | + |
| 47 | +1. Connectez-vous au [portail Microsoft Azure](https://go.microsoft.com/fwlink/?linkid=2083908) à l’aide d’un compte professionnel ou scolaire, ou d’un compte Microsoft personnel. |
| 48 | +2. Si votre compte vous donne accès à plusieurs locataires, sélectionnez votre compte en haut à droite et définissez votre session de portail sur le locataire Azure AD souhaité. |
| 49 | +3. Sélectionnez **Nouvelle inscription**. |
| 50 | +4. Lorsque la page Inscrire une application s’affiche, saisissez les informations d’inscription de votre application : |
| 51 | + * **Nom** : saisissez un nom d’application cohérent qui s’affichera pour les utilisateurs de l’application. |
| 52 | + * **Types de compte pris en charge** : sélectionnez les comptes à prendre en charge par l’application. |
| 53 | + * **URI de redirection (facultatif)** : sélectionnez **Web** et entrez 'http://localhost:55065/ » pour l’**URI de redirection**. |
| 54 | +5. Lorsque vous avez terminé, sélectionnez **Inscrire**. |
| 55 | +6. Azure AD attribue un ID d’application unique (client) à votre application, et vous êtes redirigé vers la page Vue d’ensemble de votre application. Pour ajouter des fonctionnalités supplémentaires à votre application, vous pouvez sélectionner d’autres options de configuration, dont la personnalisation, les certificats et les secrets, les autorisations API, et plus encore. |
| 56 | + |
| 57 | + Copiez l’ID de l’application. Il s’agit de l’identificateur unique de votre application. |
| 58 | +7. Sous **Gérer** dans le volet gauche, cliquez sur **Certificats et clés secrètes**. Sous **Clés secrètes client**, cliquez sur **Nouvelle clé secrète client**. Entrez une description et une date d’expiration, puis cliquez sur **Ajouter**. Cette opération crée une chaîne secrète ou un mot de passe utilisé par l’application pour prouver son identité. |
| 59 | + |
| 60 | + Copiez la valeur de la nouvelle clé secrète. |
| 61 | +8. Sous **Gérer** dans le volet gauche, cliquez sur **Authentification**. Sous **Octroi implicite**, vérifiez **Jetons d’accès** et **Jetons d’ID**. Lors de l’authentification, cela permet à l’application de recevoir les informations de connexion (id\_token) et les artefacts (dans ce cas, un code d’autorisation) qui servent à obtenir un jeton d’accès. Enregistrez vos modifications. |
| 62 | +9. Sous **Gérer** dans le volet gauche, cliquez sur **Autorisations de l’API**, puis sur **Ajouter une nouvelle autorisation**. Sélectionnez **Microsoft Graph**, puis **Autorisations déléguées**. Ajoutez les autorisations 'Group.ReadWrite.All' (lire et écrire tous les groupes) et 'User.ReadWrite.All' (lire et écrire le profil complet de tous les utilisateurs). Cliquez de nouveau sur **Ajouter une nouvelle autorisation**, puis sur **Autorisations d’application**. Ajoutez les autorisations 'Group.ReadWrite.All' (lire et écrire tous les groupes) et 'User.ReadWrite.All' (lire et écrire le profil complet de tous les utilisateurs). |
| 63 | + |
| 64 | +Pour plus d’informations, consultez les fichiers readme du projet en question. |
| 65 | + |
| 66 | +### Créer et exécuter l’exemple d’application |
| 67 | + |
| 68 | +1. Ouvrez l’exemple de solution dans Visual Studio. |
| 69 | +2. Procurez-vous votre ID d’application et la clé secrète de l’application à partir de la section précédente. |
| 70 | +3. Créez un fichier nommé Web.config.secrets (placez-le en regard de Web.config), puis ajoutez votre ID et votre clé secrète d’application : |
| 71 | + |
| 72 | +``` |
| 73 | +<?xml version="1.0" encoding="utf-8"?> |
| 74 | + <appSettings > |
| 75 | + <add key="ida:AppId" value="xxxxx"/> |
| 76 | + <add key="ida:AppSecret" value="xxxxx"/> |
| 77 | + </appSettings> |
| 78 | +``` |
| 79 | + |
| 80 | +4. Mettez à jour le 'serveur Web' de votre application Web avec l’option 'Ida:RedirectUri' de votre application inscrite. |
| 81 | + |
| 82 | +* Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet d’application Web pour lequel vous voulez spécifier un serveur Web, puis cliquez sur 'Propriétés'. |
| 83 | +* Dans la fenêtre 'Propriétés', cliquez sur l’onglet 'Web'. |
| 84 | +* Sous 'Serveurs', mettez à jour l’URL du projet avec l'option 'Ida:RedirectUri' de votre application inscrite. |
| 85 | +* Cliquez sur 'Créer un répertoire virtuel'. |
| 86 | +* Enregistrez le fichier. |
| 87 | + |
| 88 | +5. Créez et exécutez l’exemple. |
| 89 | + |
| 90 | +6. Connectez-vous à votre compte, puis accordez les autorisations demandées. |
| 91 | + |
| 92 | +* Remarque : vous devez disposer des droits élevés appropriés pour exécuter l’application (Group.ReadWrite.All et User.ReadWrite.All) |
| 93 | + |
| 94 | +7. Sélectionnez l’opération, par exemple, 'Obtenir mes équipes', 'Obtenir des canaux', 'Créer un canal' ou 'Envoyer un message'. |
| 95 | + |
| 96 | +8. Les informations de réponse s’affichent en bas de la page. |
| 97 | + |
| 98 | +## Commentaires |
| 99 | + |
| 100 | +Vos commentaires sont les bienvenus ! [Pour nous envoyer les vôtres, procédez comme suit](https://msdn.microsoft.com/en-us/microsoft-teams/feedback). |
| 101 | + |
| 102 | +## Code de conduite Open Source de Microsoft |
| 103 | + |
| 104 | +Ce projet a adopté le [Code de conduite Open Source de Microsoft ](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite ](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [[email protected]](mailto:[email protected]) pour toute question ou tout commentaire. |
| 105 | + |
| 106 | +## Contribution |
| 107 | + |
| 108 | +Consultez [Contribution](contributing.md) pour en savoir plus sur le processus de soumission des demandes de réception. |
| 109 | + |
| 110 | +## Licence |
| 111 | + |
| 112 | +Ce projet a fait l’objet d’une licence en vertu de la licence MIT. Consultez le fichier de [Licence](LICENSE) pour plus de détails. |
| 113 | + |
| 114 | +## Copyright |
| 115 | + |
| 116 | +Copyright (c) 2018 Microsoft Corporation. Tous droits réservés. |
0 commit comments