Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Utilisation de Visual Studio pour enregistrer votre application et ajouter des API Office 365

Concerne : Office 365

Après avoir configurer votre environnement de développement, vous êtes prêt à ajouter un service d'API Office 365 à votre projet Visual Studio.

Dans cet article

Lorsque vous ajoutez un service Office 365 à votre projet, Visual Studio vous aide à enregistrer votre application

Les services de l'API Office 365 utilisent Azure AD pour fournir une authentification sécurisée aux données Office 365 des utilisateurs. Pour accéder aux API Office 365, vous devez enregistrer votre application auprès d'Azure AD.

Si vous créez un projet Visual Studio, l'enregistrement de l'application est géré pour vous lorsque vous ajoutez un service Office 365 à votre projet.

Sélectionnez la version de Visual Studio que vous utilisez :

Au cours du processus d'ajout d'un service Office 365 à votre projet, Visual Studio vous permet de:

  • Enregistrez votre application avec Azure AD, notamment en spécifiant si votre application est une application Web ou une application native
  • Configurer les propriétés de l'application, telles que le nom de l'application, les points de terminaison de redirection / réponse et l'étendue de la location
  • Enregistrer votre application auprès de Azure AD
  • Connecter aux services Office 365
  • Indiquer les niveaux d'autorisation requis par votre application pour les API dans ces services Office 365
  • Ajoutez les Forfaits NuGet requis au projet, en fonction des services Office 365 auxquels votre application est connectée

Les modèles de projet suivants prennent en charge l'ajout d'API Office 365 en tant que service connecté :

  • Applications .NET Windows Store 8.1
  • Applications universelles .NET Windows Store 8.1
  • Applications .NET Windows Phone 8.1
  • Applications .NET Windows Phone 8.1 Silverlight
  • Applications Windows Forms
  • Applications XPF
  • Applications Web ASP.NET MVC
  • Applications ASP.NET Web Forms
  • Applications Xamarin Android et iOS
  • Applications hybrides multi-périphériques (Cordova)

Si vous ne disposez pas d'un projet Visual Studio existant dans lequel vous souhaitez utiliser les API Office 365, ou si vous souhaitez essayer des projets terminés qui utilisent les API Office 365, téléchargez l'un des projets répertoriés sur la page dans la liste. Projets de démarrage d'API Office 365 et exemples de code.

Conditions préalables à l'enregistrement de vos applications avec Azure AD à l'aide de Visual Studio

Pour enregistrer vos applications, vous aurez besoin de :

Utilisez Visual Studio Service Manager pour enregistrer votre application et ajouter des API Office 365 à votre projet

Vous ajoutez et configurez les API Office 365 en utilisant le Gestionnaire des services dans Visual Studio.

  1. Dans l' Explorateur de solution, choisissez le nœud de projet auquel vous souhaitez ajouter un service Office 365

  2. Cliquez avec le bouton droit de la souris ou pressez et maintenez le nœud du projet enfoncé et choisissez Ajouter > Service connecté.

  3. Enregistrez votre application :

    Au sommet de la boîte de dialogue Gestionnaire des services , choisissez le lien Bureau 365, puis choisissez Enregistrez votre application . Connectez-vous avec un compte d'administrateur de locataire pour votre organisation de développeur Office 365.

    Ceci démarre l'enregistrement de l'application dans Microsoft Azure Active Directory, ce qui permet à votre application de s'authentifier via OAuth.

    Une fois que vous avez ouvert une session sur Office 365, une liste des services d'API Office 365 disponibles s'affiche. Vous verrez une liste d'API Office 365.

    Vous verrez que la colonne Autorisations à droite de chaque service est vide.

  4. Sélectionnez les API Office 365 auxquelles vous souhaitez vous connecter et spécifiez les niveaux d'autorisation pour chacune :

    Dans la liste :

    1. Sélectionnez les API Office 365 que vous souhaitez ajouter
    2. Choisir Autorisations.

      Une capture d'écran qui affiche la boîte de dialogue Gestionnaire de services avec l'API Office 365 du service Calendrier sélectionnée et le lien Autorisations mis en surbrillance.

      Dans la boîte de dialogue Autorisations [Service Office 365] boite de dialogue :

    3. Sélectionnez les autorisations requises pour votre projet

    4. Choisissez Appliquer.

      Capture d’écran de la boîte de dialogue Autorisations du calendrier avec l’autorisation Lire les calendriers des utilisateurs sélectionnée.

      Lorsque vous effectuez ceci, Visual Studio ajoute le(s) service(s) Office 365 contenant les API que vous avez sélectionnées à votre application dans Azure AD et définit les niveaux d'autorisation pour les API tels que vous avez spécifiés.

  5. Définir les propriétés de votre application :

    Choisir Propriétés de l'application dans la boite de dialogue du Gestionnaire des services .

    Les propriétés de l'application que vous pouvez définir diffèrent selon que votre projet d'application est un service Web ou une application Web ou une application native, telle qu'un projet de téléphone mobile.

    Par exemple, pour les applications Web, pour rendre cet exemple d'application disponible pour les organisations Office 365 autres que votre organisation de développeur :

    1. Changer le paramètre Rendre cette application disponible pour : en Organisations multiples
    2. Choisissez Appliquer.

      Une capture d'écran de la boîte de dialogue Propriétés de l'application Office 365 indiquant le paramètre à sélectionner pour rendre votre application disponible auprès de plusieurs organisations.

      La boîte de dialogue Gestionnaire des services liste maintenant :

    3. Le (s) service (s) que vous avez choisi d'ajouter à votre projet

    4. Les autorisations pour chaque service.

      Une capture d'écran de la boîte de dialogue Gestionnaire des services après la configuration du service Calendrier, indiquant que le service Calendrier dispose d'autorisations de lecture.

  6. Sélectionnez OK.

À ce stade, Visual Studio ajoute les Packages NuGet au projet. Les packages NuGet ajoutés varient en fonction des API Office 365 que vous avez ajoutées.

  1. Dans l' Explorateur de solutions, choisissez le nœud de projet auquel vous souhaitez ajouter un service Office 365.

  2. Cliquez avec le bouton droit de la souris ou pressez et maintenez le nœud du projet enfoncé et choisissez Ajouter > Service connecté.

  3. Sur l'onglet Microsoft , choisissez l' API Office 365, et choisissez Configurer.

    La boîte de dialogue Configurer les services d'API Office 365 apparaît.

  4. Enregistrez votre application :

    Sur la page Sélectionner un domaine, entrez ou sélectionnez le domaine Office 365 dans lequel vous souhaitez enregistrer votre application ; par exemple, contoso.onmicrosoft.com. Cliquez sur Suivant. Vous devrez peut-être ouvrir une session dans Office 365 si vous n'êtes pas déjà connecté.

    Sur la page Configurer l'application , choisissez de créer une nouvelle application Azure AD ou d'en utiliser une existante. Si vous choisissez d'utiliser une application Azure AD existante, entrez l'ID client de cette application.

    Si vous voulez utiliser l'authentification unique avec votre application, cochez la case. L'authentification unique nécessitant SSL, la sélection de cette option active automatiquement SSL dans votre projet.

    Cliquez sur Suivant.

    Visual Studio enregistre votre application.

  5. Sélectionnez les API Office 365 auxquelles vous souhaitez vous connecter et spécifiez les niveaux d'autorisation pour chacune :

    1. Sélectionnez l'API Office 365 ; par exemple, Contacts ou Mes fichiers.

    2. Choisissez la ou les autorisation(s) requises pour votre application.

      Rappelez-vous que les autorisations ont une portée additive. Par exemple, pour l'API Mail, l'autorisation Lire et écrire votre courrier comprend l'autorisation Lire votre courrier , vous n'avez donc pas besoin de sélectionner les deux. En général, sélectionnez l'autorisation la moins étendue qui permet toutefois à votre application d'accomplir tout ce qu'elle doit faire.

    3. Cliquez sur Suivant.

      Lorsque vous effectuez ceci, Visual Studio ajoute le(s) service(s) Office 365 contenant les API que vous avez sélectionnées à votre application dans Azure AD et définit les niveaux d'autorisation pour les API tels que vous avez spécifiés.

  6. Lorsque vous avez ajoutées toutes les API requises par votre application, choisissez Terminer.

À ce stade, Visual Studio ajoute les Packages NuGet au projet. Les packages NuGet ajoutés varient en fonction des API Office 365 que vous avez ajoutées.

Ajoutez manuellement des packages NuGet de la bibliothèque du client de l'API Office 365 en option à votre projet

Les outils Office 365 ajoutent automatiquement les packages NuGet nécessaires lorsque vous ajoutez un service Office 365, mais vous pouvez également ajouter et gérer manuellement les packages NuGet à l'aide de la commande Gérer la boîte de dialogue Packages NuGet ou la Console du gestionnaire de package NuGet et PowerShell.

Le tableau suivant répertorie les packages NuGet requis, en fonction du service API Office 365 que vous ajoutez et du type de projet que vous avez créé.

Service Office 365Applications Windows Store .NET (Windows Store et Windows Phone)Applications Windows Desktop (WPF et Windows Forms)Applications Web ASP.NET (MVC et Web Forms)Applications Xamarin (iOS et Android)Applications Cordova
Utilisateurs et graphiquesMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClientMicrosoft.Azure.ActiveDirectory.GraphClient.JS
Services OutlookMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServicesMicrosoft.Office365.OutlookServices
Services SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePointMicrosoft.Office365.SharePoint
Client DiscoveryMicrosoft.Office365.DiscoveryMicrosoft.Office365.DiscoveryMicrosoft.Office365.DiscoveryMicrosoft.Office365.Discovery
Tout serviceMicrosoft.Office365.OAuth.XamarinMicrosoft.Office365.ClientLib.JS

En fonction de votre type de projet, certains packages NuGet sont requis lors de l'ajout d'un service Office 365 quelconque :

Xamarin Studio offre désormais un support pour la gestion des paquets NuGet.

Étapes suivantes

Une fois que vous avez ajouté un service O365 à votre application, vous devez l'authentifier auprès d'Office 365 afin d'accéder aux données de votre utilisateur. Voir Intégrer les API Office 365 dans les projets .NET Visual Studio pour plus de détails.

© 2018 Microsoft