Création d’applications Java avec Microsoft Graph

Ce tutoriel vous apprend à créer une application console Java qui utilise l’API Microsoft Graph pour accéder aux données pour le compte d’un utilisateur.

Dans ce didacticiel, vous allez :

• Obtenir l’utilisateur connecté
• Répertorier les messages de la boîte de réception de l’utilisateur
• Envoyer un courrier électronique

Configuration requise

Avant de commencer ce didacticiel, vous devez avoir installé le kit de développement Java SE (JDK) et Gradle sur votre ordinateur de développement.

Vous devez également disposer d’un compte professionnel ou scolaire Microsoft avec une boîte aux lettres Exchange Online. Si vous n’avez pas de locataire Microsoft 365, vous pouvez être éligible pour un client via le Programme pour les développeurs Microsoft 365 ; Pour plus d’informations, consultez la FAQ. Vous pouvez également vous inscrire à un essai gratuit de 1 mois ou acheter un plan Microsoft 365.

Inscrire l’application sur le portail

• 27 minutes restantes

Dans cet exercice, vous allez inscrire une nouvelle application dans Azure Active Directory pour activer l’authentification utilisateur. Vous pouvez inscrire une application à l’aide du Centre d’administration Microsoft Entra ou à l’aide du Kit de développement logiciel (SDK) Microsoft Graph PowerShell.

Inscrire l’application pour l’authentification utilisateur

Dans cette section, vous allez inscrire une application qui prend en charge l’authentification utilisateur à l’aide du flux de code d’appareil.

Créer une application de console Java

• 25 minutes restantes

Dans cette section, vous allez créer une application console Java de base.

1. Ouvrez votre interface de ligne de commande (CLI) dans un répertoire dans lequel vous souhaitez créer le projet. Exécutez la commande suivante pour créer un projet Gradle.

   gradle init --dsl groovy --test-framework junit --type java-application --project-name graphtutorial --package graphtutorial
   

2. Une fois le projet créé, vérifiez qu’il fonctionne en exécutant la commande suivante pour exécuter l’application dans votre interface CLI.

   ./gradlew --console plain run
   

   Si cela fonctionne, l’application doit générer Hello World..

Installer les dépendances

Avant de continuer, ajoutez des dépendances supplémentaires que vous utiliserez ultérieurement.

• Bibliothèque de client Azure Identity pour Java afin d’authentifier l’utilisateur et d’acquérir des jetons d’accès.
• Kit de développement logiciel (SDK) Microsoft Graph pour Java afin d’effectuer des appels à Microsoft Graph.

1. Ouvrez ./app/build.gradle. Mettez à jour la dependencies section pour ajouter ces dépendances.

   dependencies {
       // Use JUnit test framework.
       testImplementation 'junit:junit:4.13.2'
   
       // This dependency is used by the application.
       implementation 'com.google.guava:guava:33.2.1-jre'
       implementation 'com.azure:azure-identity:1.13.0'
       implementation 'com.microsoft.graph:microsoft-graph:6.13.0'
   }
   

2. Ajoutez ce qui suit à la fin de ./app/build.gradle.

   run {
       standardInput = System.in
   }
   

   La prochaine fois que vous générerez le projet, Gradle téléchargera ces dépendances.

Charger les paramètres de l’application

Dans cette section, vous allez ajouter les détails de l’inscription de votre application au projet.

1. Créez un répertoire nommé graphtutorial dans le répertoire ./app/src/main/resources .

2. Créez un fichier dans le répertoire ./app/src/main/resources/graphtutorial nommé oAuth.properties, puis ajoutez le texte suivant dans ce fichier.

   app.clientId=YOUR_CLIENT_ID_HERE
   app.tenantId=common
   app.graphUserScopes=user.read,mail.read,mail.send
   

3. Mettez à jour les valeurs en fonction du tableau suivant.

   Paramètre	Valeur
   app.clientId	ID client de l’inscription de votre application
   app.tenantId	Si vous avez choisi l’option pour autoriser uniquement les utilisateurs de votre organisation à se connecter, remplacez cette valeur par votre ID de locataire. Sinon, laissez comme common.

   Importante

   Si vous utilisez un contrôle de code source tel que Git, il serait temps d’exclure le fichier oAuth.properties du contrôle de code source afin d’éviter la fuite par inadvertance de votre ID d’application.

Concevoir l’application

Dans cette section, vous allez créer un menu simple basé sur la console.

1. Ouvrez ./app/src/main/java/graphtutorial/App.java et ajoutez les instructions suivantes import .

   package graphtutorial;
   
   import java.io.IOException;
   import java.time.ZoneId;
   import java.time.format.DateTimeFormatter;
   import java.time.format.FormatStyle;
   import java.util.InputMismatchException;
   import java.util.Properties;
   import java.util.Scanner;
   
   import com.microsoft.graph.models.Message;
   import com.microsoft.graph.models.MessageCollectionResponse;
   import com.microsoft.graph.models.User;
   

2. Remplacez la fonction main existante par ce qui suit.

   public static void main(String[] args) {
       System.out.println("Java Graph Tutorial");
       System.out.println();
   
       final Properties oAuthProperties = new Properties();
       try {
           oAuthProperties.load(App.class.getResourceAsStream("oAuth.properties"));
       } catch (IOException e) {
           System.out.println("Unable to read OAuth configuration. Make sure you have a properly formatted oAuth.properties file. See README for details.");
           return;
       }
   
       initializeGraph(oAuthProperties);
   
       greetUser();
   
       Scanner input = new Scanner(System.in);
   
       int choice = -1;
   
       while (choice != 0) {
           System.out.println("Please choose one of the following options:");
           System.out.println("0. Exit");
           System.out.println("1. Display access token");
           System.out.println("2. List my inbox");
           System.out.println("3. Send mail");
           System.out.println("4. Make a Graph call");
   
           try {
               choice = input.nextInt();
           } catch (InputMismatchException ex) {
               // Skip over non-integer input
           }
   
           input.nextLine();
   
           // Process user choice
           switch(choice) {
               case 0:
                   // Exit the program
                   System.out.println("Goodbye...");
                   break;
               case 1:
                   // Display access token
                   displayAccessToken();
                   break;
               case 2:
                   // List emails from user's inbox
                   listInbox();
                   break;
               case 3:
                   // Send an email message
                   sendMail();
                   break;
               case 4:
                   // Run any Graph code
                   makeGraphCall();
                   break;
               default:
                   System.out.println("Invalid choice");
           }
       }
   
       input.close();
   }
   

3. Ajoutez les méthodes d’espace réservé suivantes à la fin du fichier. Vous les implémenterez dans les étapes ultérieures.

   private static void initializeGraph(Properties properties) {
       // TODO
   }
   
   private static void greetUser() {
       // TODO
   }
   
   private static void displayAccessToken() {
       // TODO
   }
   
   private static void listInbox() {
       // TODO
   }
   
   private static void sendMail() {
       // TODO
   }
   
   private static void makeGraphCall() {
       // TODO
   }
   

Cela implémente un menu de base et lit le choix de l’utilisateur à partir de la ligne de commande.

1. Supprimez ./app/src/test/java/graphtutorial/AppTest.java.

Ajouter l’authentification utilisateur

• 19 minutes restantes

Dans cette section, vous allez étendre l’application de l’exercice précédent pour prendre en charge l’authentification avec Azure AD. Cela est nécessaire pour obtenir le jeton d’accès OAuth nécessaire pour appeler Microsoft Graph. Dans cette étape, vous allez intégrer la bibliothèque de client Azure Identity pour Java dans l’application et configurer l’authentification pour le Kit de développement logiciel (SDK) Microsoft Graph pour Java.

La bibliothèque Azure Identity fournit un certain nombre de TokenCredential classes qui implémentent des flux de jetons OAuth2. La bibliothèque de client Microsoft Graph utilise ces classes pour authentifier les appels à Microsoft Graph.

Configurer le client Graph pour l’authentification utilisateur

Dans cette section, vous allez utiliser la DeviceCodeCredential classe pour demander un jeton d’accès à l’aide du flux de code de l’appareil.

1. Créez un fichier dans le répertoire ./app/src/main/java/graphtutorial nommé Graph.java et ajoutez le code suivant à ce fichier.

   package graphtutorial;
   
   import java.util.List;
   import java.util.Properties;
   import java.util.function.Consumer;
   
   import com.azure.core.credential.AccessToken;
   import com.azure.core.credential.TokenRequestContext;
   import com.azure.identity.DeviceCodeCredential;
   import com.azure.identity.DeviceCodeCredentialBuilder;
   import com.azure.identity.DeviceCodeInfo;
   import com.microsoft.graph.models.BodyType;
   import com.microsoft.graph.models.EmailAddress;
   import com.microsoft.graph.models.ItemBody;
   import com.microsoft.graph.models.Message;
   import com.microsoft.graph.models.MessageCollectionResponse;
   import com.microsoft.graph.models.Recipient;
   import com.microsoft.graph.models.User;
   import com.microsoft.graph.serviceclient.GraphServiceClient;
   import com.microsoft.graph.users.item.sendmail.SendMailPostRequestBody;
   

2. Ajoutez une définition de classe Graph vide.

   public class Graph {
   }
   

3. Ajoutez le code suivant à la classe Graph.

   private static Properties _properties;
   private static DeviceCodeCredential _deviceCodeCredential;
   private static GraphServiceClient _userClient;
   
   public static void initializeGraphForUserAuth(Properties properties, Consumer<DeviceCodeInfo> challenge) throws Exception {
       // Ensure properties isn't null
       if (properties == null) {
           throw new Exception("Properties cannot be null");
       }
   
       _properties = properties;
   
       final String clientId = properties.getProperty("app.clientId");
       final String tenantId = properties.getProperty("app.tenantId");
       final String[] graphUserScopes = properties.getProperty("app.graphUserScopes").split(",");
   
       _deviceCodeCredential = new DeviceCodeCredentialBuilder()
           .clientId(clientId)
           .tenantId(tenantId)
           .challengeConsumer(challenge)
           .build();
   
       _userClient = new GraphServiceClient(_deviceCodeCredential, graphUserScopes);
   }
   

4. Remplacez la fonction vide initializeGraph dans App.java par ce qui suit.

   private static void initializeGraph(Properties properties) {
       try {
           Graph.initializeGraphForUserAuth(properties,
               challenge -> System.out.println(challenge.getMessage()));
       } catch (Exception e)
       {
           System.out.println("Error initializing Graph for user auth");
           System.out.println(e.getMessage());
       }
   }
   

Ce code déclare deux propriétés privées, un DeviceCodeCredential objet et un GraphServiceClient objet . La InitializeGraphForUserAuth fonction crée une instance de DeviceCodeCredential, puis utilise cette instance pour créer une nouvelle instance de GraphServiceClient. Chaque fois qu’un appel d’API est effectué à Microsoft Graph via , _userClientil utilise les informations d’identification fournies pour obtenir un jeton d’accès.

Tester deviceCodeCredential

Ensuite, ajoutez du code pour obtenir un jeton d’accès à partir de .DeviceCodeCredential

1. Ajoutez la fonction suivante à la classe Graph.

   public static String getUserToken() throws Exception {
       // Ensure credential isn't null
       if (_deviceCodeCredential == null) {
           throw new Exception("Graph has not been initialized for user auth");
       }
   
       final String[] graphUserScopes = _properties.getProperty("app.graphUserScopes").split(",");
   
       final TokenRequestContext context = new TokenRequestContext();
       context.addScopes(graphUserScopes);
   
       final AccessToken token = _deviceCodeCredential.getTokenSync(context);
       return token.getToken();
   }
   

2. Remplacez la fonction vide displayAccessToken dans App.java par ce qui suit.

   private static void displayAccessToken() {
       try {
           final String accessToken = Graph.getUserToken();
           System.out.println("Access token: " + accessToken);
       } catch (Exception e) {
           System.out.println("Error getting access token");
           System.out.println(e.getMessage());
       }
   }
   

3. Générez et exécutez l’application. Entrez 1 lorsque vous êtes invité à entrer une option. L’application affiche une URL et un code d’appareil.

   Java Graph Tutorial
   
   Please choose one of the following options:
   0. Exit
   1. Display access token
   2. List my inbox
   3. Send mail
   4. Make a Graph call
   1
   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and
   enter the code RB2RUD56D to authenticate.
   

4. Ouvrez un navigateur et accédez à l’URL affichée. Entrez le code fourni et connectez-vous.

   Importante

   Gardez à l’esprit tous les comptes Microsoft 365 existants qui sont connectés à votre navigateur lorsque vous accédez à https://microsoft.com/devicelogin. Utilisez les fonctionnalités du navigateur telles que les profils, le mode invité ou le mode privé pour vous assurer que vous vous authentifiez en tant que compte que vous envisagez d’utiliser pour les tests.

5. Une fois terminé, revenez à l’application pour voir le jeton d’accès.

   Conseil

   À des fins de validation et de débogage uniquement, vous pouvez décoder les jetons d’accès utilisateur (pour les comptes professionnels ou scolaires uniquement) à l’aide de l’analyseur de jetons en ligne de Microsoft à l’adresse https://jwt.ms. Cela peut être utile si vous rencontrez des erreurs de jeton lors de l’appel de Microsoft Graph. Par exemple, vérifier que la revendication dans le scp jeton contient les étendues d’autorisation Microsoft Graph attendues.

Obtenir un utilisateur

• 14 minutes restantes

Dans cette section, vous allez incorporer Microsoft Graph dans l’application. Pour cette application, vous allez utiliser la bibliothèque cliente Java Microsoft Graph pour effectuer des appels à Microsoft Graph.

1. Ouvrez Graph.java et ajoutez la fonction suivante à la classe Graph .

   public static User getUser() throws Exception {
       // Ensure client isn't null
       if (_userClient == null) {
           throw new Exception("Graph has not been initialized for user auth");
       }
   
       return _userClient.me().get(requestConfig -> {
           requestConfig.queryParameters.select = new String[] {"displayName", "mail", "userPrincipalName"};
       });
   }
   

2. Remplacez la fonction vide greetUser dans App.java par ce qui suit.

   private static void greetUser() {
       try {
           final User user = Graph.getUser();
           // For Work/school accounts, email is in mail property
           // Personal accounts, email is in userPrincipalName
           final String email = user.getMail() == null ? user.getUserPrincipalName() : user.getMail();
           System.out.println("Hello, " + user.getDisplayName() + "!");
           System.out.println("Email: " + email);
       } catch (Exception e) {
           System.out.println("Error getting user");
           System.out.println(e.getMessage());
       }
   }
   

Si vous exécutez l’application maintenant, une fois que vous vous êtes connecté, l’application vous accueille par son nom.

Hello, Megan Bowen!
Email: MeganB@contoso.com

Explication du code

Considérez le code dans la greetUser fonction . Il ne s’agit que de quelques lignes, mais il y a quelques détails clés à noter.

Accès à « moi »

La fonction utilise le générateur de _userClient.me requêtes, qui génère une requête à l’API Get user . Cette API est accessible de deux façons :

GET /me
GET /users/{user-id}

Dans ce cas, le code appelle le point de terminaison d’API GET /me . Il s’agit d’une méthode de raccourci permettant d’obtenir l’utilisateur authentifié sans connaître son ID d’utilisateur.

Demande de propriétés spécifiques

La fonction utilise la select propriété sur la configuration de la demande pour spécifier le jeu de propriétés dont elle a besoin. Cela ajoute le paramètre de requête $select à l’appel d’API.

Type de retour fortement typé

La fonction retourne un com.microsoft.graph.models.User objet désérialisé à partir de la réponse JSON de l’API. Étant donné que le code utilise select, seules les propriétés demandées auront des valeurs dans l’objet retourné User . Toutes les autres propriétés ont des valeurs par défaut.

Boîte de réception de liste

• 11 minutes restantes

Dans cette section, vous allez ajouter la possibilité de répertorier les messages dans la boîte de réception de messagerie de l’utilisateur.

1. Ouvrez Graph.java et ajoutez la fonction suivante à la classe Graph .

   public static MessageCollectionResponse getInbox() throws Exception {
       // Ensure client isn't null
       if (_userClient == null) {
           throw new Exception("Graph has not been initialized for user auth");
       }
   
       return _userClient.me()
           .mailFolders()
           .byMailFolderId("inbox")
           .messages()
           .get(requestConfig -> {
               requestConfig.queryParameters.select = new String[] { "from", "isRead", "receivedDateTime", "subject" };
               requestConfig.queryParameters.top = 25;
               requestConfig.queryParameters.orderby = new String[] { "receivedDateTime DESC" };
           });
   }
   

2. Remplacez la fonction vide listInbox dans App.java par ce qui suit.

   private static void listInbox() {
       try {
           final MessageCollectionResponse messages = Graph.getInbox();
   
           // Output each message's details
           for (Message message: messages.getValue()) {
               System.out.println("Message: " + message.getSubject());
               System.out.println("  From: " + message.getFrom().getEmailAddress().getName());
               System.out.println("  Status: " + (message.getIsRead() ? "Read" : "Unread"));
               System.out.println("  Received: " + message.getReceivedDateTime()
                   // Values are returned in UTC, convert to local time zone
                   .atZoneSameInstant(ZoneId.systemDefault()).toLocalDateTime()
                   .format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT)));
           }
   
           final Boolean moreMessagesAvailable = messages.getOdataNextLink() != null;
           System.out.println("\nMore messages available? " + moreMessagesAvailable);
       } catch (Exception e) {
           System.out.println("Error getting inbox");
           System.out.println(e.getMessage());
       }
   }
   

3. Exécutez l’application, connectez-vous et choisissez l’option 2 pour répertorier votre boîte de réception.

   Please choose one of the following options:
   0. Exit
   1. Display access token
   2. List my inbox
   3. Send mail
   4. Make a Graph call
   2
   Message: Updates from Ask HR and other communities
     From: Contoso Demo on Yammer
     Status: Read
     Received: 12/30/2021, 4:54:54 AM
   Message: Employee Initiative Thoughts
     From: Patti Fernandez
     Status: Read
     Received: 12/28/2021, 5:01:10 PM
   Message: Voice Mail (11 seconds)
     From: Alex Wilber
     Status: Unread
     Received: 12/28/2021, 5:00:46 PM
   Message: Our Spring Blog Update
     From: Alex Wilber
     Status: Unread
     Received: 12/28/2021, 4:49:46 PM
   Message: Atlanta Flight Reservation
     From: Alex Wilber
     Status: Unread
     Received: 12/28/2021, 4:35:42 PM
   Message: Atlanta Trip Itinerary - down time
     From: Alex Wilber
     Status: Unread
     Received: 12/28/2021, 4:22:04 PM
   
   ...
   
   More messages available? true
   

Explication du code

Considérez le code dans la getInbox fonction .

Accès aux dossiers de courrier connus

La fonction utilise le générateur de _userClient.me().mailFolders().byMailFolderId("inbox").messages() requêtes, qui génère une requête à l’API Répertorier les messages . Étant donné qu’elle inclut le byMailFolderId("inbox") générateur de requêtes, l’API retourne uniquement les messages dans le dossier de messagerie demandé. Dans ce cas, étant donné que la boîte de réception est un dossier par défaut connu dans la boîte aux lettres d’un utilisateur, elle est accessible via son nom connu. Les dossiers autres que les dossiers par défaut sont accessibles de la même façon, en remplaçant le nom connu par la propriété ID du dossier de messagerie. Pour plus d’informations sur les noms de dossiers connus disponibles, consultez Type de ressource mailFolder.

Accès à une collection

Contrairement à la getUser fonction de la section précédente, qui retourne un seul objet, cette méthode retourne une collection de messages. La plupart des API de Microsoft Graph qui retournent une collection ne retournent pas tous les résultats disponibles dans une seule réponse. Au lieu de cela, ils utilisent la pagination pour retourner une partie des résultats tout en fournissant une méthode permettant aux clients de demander la « page » suivante.

Tailles de page par défaut

Les API qui utilisent la pagination implémentent une taille de page par défaut. Pour les messages, la valeur par défaut est 10. Les clients peuvent demander plus (ou moins) à l’aide du paramètre de requête $top . Dans getInbox, cette opération s’effectue avec la top propriété dans la configuration de la requête.

Obtention des pages suivantes

Si d’autres résultats sont disponibles sur le serveur, les réponses de regroupement incluent une @odata.nextLink propriété avec une URL d’API pour accéder à la page suivante. La bibliothèque de client Java expose cela en tant que méthode sur les getOdataNextLink objets de réponse de collection. Si cette méthode retourne une valeur non null, d’autres résultats sont disponibles.

Tri des collections

La fonction utilise la orderBy propriété sur la configuration de la demande pour demander des résultats triés en fonction de la réception du message (receivedDateTime propriété ). Il inclut le mot clé afin que les DESC messages reçus plus récemment soient répertoriés en premier. Cela ajoute le paramètre de requête $orderby à l’appel d’API.

Envoyer un message

• 8 minutes restantes

Dans cette section, vous allez ajouter la possibilité d’envoyer un e-mail en tant qu’utilisateur authentifié.

1. Ouvrez Graph.java et ajoutez la fonction suivante à la classe Graph .

   public static void sendMail(String subject, String body, String recipient) throws Exception {
       // Ensure client isn't null
       if (_userClient == null) {
           throw new Exception("Graph has not been initialized for user auth");
       }
   
       // Create a new message
       final Message message = new Message();
       message.setSubject(subject);
       final ItemBody itemBody = new ItemBody();
       itemBody.setContent(body);
       itemBody.setContentType(BodyType.Text);
       message.setBody(itemBody);
   
       final EmailAddress emailAddress = new EmailAddress();
       emailAddress.setAddress(recipient);
       final Recipient toRecipient = new Recipient();
       toRecipient.setEmailAddress(emailAddress);
       message.setToRecipients(List.of(toRecipient));
   
       final SendMailPostRequestBody postRequest = new SendMailPostRequestBody();
       postRequest.setMessage(message);
   
       // Send the message
       _userClient.me()
           .sendMail()
           .post(postRequest);
   }
   

2. Remplacez la fonction vide sendMail dans App.java par ce qui suit.

   private static void sendMail() {
       try {
           // Send mail to the signed-in user
           // Get the user for their email address
           final User user = Graph.getUser();
           final String email = user.getMail() == null ? user.getUserPrincipalName() : user.getMail();
   
           Graph.sendMail("Testing Microsoft Graph", "Hello world!", email);
           System.out.println("\nMail sent.");
       } catch (Exception e) {
           System.out.println("Error sending mail");
           System.out.println(e.getMessage());
       }
   }
   

3. Exécutez l’application, connectez-vous et choisissez l’option 3 pour vous envoyer un e-mail.

   Please choose one of the following options:
   0. Exit
   1. Display access token
   2. List my inbox
   3. Send mail
   4. Make a Graph call
   3
   
   Mail sent.
   

   Remarque

   Si vous effectuez des tests auprès d’un locataire développeur à partir du Programme pour développeurs Microsoft 365, l’e-mail que vous envoyez risque de ne pas être remis et vous pouvez recevoir un rapport de non-remise. Si cela vous arrive, contactez le support via le Centre d’administration Microsoft 365.

4. Pour vérifier que le message a été reçu, choisissez l’option 2 pour répertorier votre boîte de réception.

Explication du code

Considérez le code dans la sendMail fonction .

Envoi de messages

La fonction utilise le générateur de _userClient.me().sendMail() requêtes, qui génère une requête à l’API Envoyer un courrier . Le générateur de requêtes prend un SendMailPostRequestBody objet contenant le message à envoyer.

Création d’objets

Contrairement aux appels précédents à Microsoft Graph qui ne lisent que les données, cet appel crée des données. Pour ce faire avec la bibliothèque cliente, vous créez une instance de la classe représentant les données (dans ce cas, com.microsoft.graph.models.Message) à l’aide du new mot clé , définissez les propriétés souhaitées, puis envoyez-la dans l’appel d’API. Étant donné que l’appel envoie des données, la post méthode est utilisée à la place de get.

Facultatif : ajouter votre propre code

• 5 minutes restantes

Dans cette section, vous allez ajouter vos propres fonctionnalités Microsoft Graph à l’application. Il peut s’agir d’un extrait de code de la documentation Microsoft Graph ou de l’Explorateur Graph, ou du code que vous avez créé. Cette section est facultative.

Mettre à jour l’application

1. Ouvrez Graph.java et ajoutez la fonction suivante à la classe Graph .

   public static void makeGraphCall() {
       // INSERT YOUR CODE HERE
   }
   

2. Remplacez la fonction vide MakeGraphCallAsync dans App.java par ce qui suit.

   private static void makeGraphCall() {
       try {
           Graph.makeGraphCall();
       } catch (Exception e) {
           System.out.println("Error making Graph call");
           System.out.println(e.getMessage());
       }
   }
   

Choisir une API

Recherchez une API dans Microsoft Graph que vous souhaitez essayer. Par exemple, l’API Créer un événement . Vous pouvez utiliser l’un des exemples de la documentation de l’API, ou vous pouvez personnaliser une demande d’API dans l’Explorateur Graph et utiliser l’extrait de code généré.

Configuration des autorisations

Consultez la section Autorisations de la documentation de référence de l’API choisie pour voir quelles méthodes d’authentification sont prises en charge. Certaines API ne prennent pas en charge les comptes Microsoft personnels ou d’application uniquement, par exemple.

• Pour appeler une API avec l’authentification utilisateur (si l’API prend en charge l’authentification utilisateur (déléguée), ajoutez l’étendue d’autorisation requise dans oAuth.properties.
• Pour appeler une API avec une authentification d’application uniquement, consultez le tutoriel sur l’authentification d’application uniquement .

Ajouter votre code

Copiez votre code dans la makeGraphCallAsync fonction dans Graph.java. Si vous copiez un extrait de code à partir de la documentation ou de l’Explorateur Graph, veillez à renommer en GraphServiceClient_userClient.

Félicitations !

• Tout est terminé !

Vous avez terminé le tutoriel Microsoft Graph java. Maintenant que vous disposez d’une application opérationnelle qui appelle Microsoft Graph, vous pouvez expérimenter et ajouter de nouvelles fonctionnalités.

• Découvrez comment utiliser l’authentification d’application uniquement avec le Kit de développement logiciel (SDK) Java Microsoft Graph.
• Consultez la vue d’ensemble de Microsoft Graph pour voir toutes les données accessibles avec Microsoft Graph.

Exemples Java

• Application Android
• Notifications de modification