Comment envoyer des courriels à l’aide de Microsoft 365 Graph API dans les applications .NET

Envoyer un courriel en C# avec l’API Microsoft 365 Graph

Intégrer l’API Microsoft Graph dans les applications .NET permet aux développeurs de simplifier le processus d’envoi de messages via les services Microsoft 365. Aspose.Email pour .NET simplifie ce processus, offrant des fonctionnalités améliorées telles que la gestion des pièces jointes, le suivi et la communication sécurisée. La bibliothèque vous permet de créer et de livrer des communications par courriel personnalisées et haute performance directement depuis vos applications .NET.

Principaux avantages d’utiliser Aspose.Email avec Microsoft Graph

• Aucun SMTP ou authentification de base requis - Utilisez une authentification sécurisée moderne basée sur les jetons (OAuth2).

• Intégration Microsoft 365 & Outlook - Connectez facilement aux boîtes aux lettres et services Microsoft 365.

• Prêt pour l’entreprise pour les développeurs .NET - Conçu pour l’évolutivité, la fiabilité et les flux de travail de messagerie d’entreprise.

• API totalement gérée - aucune dépendance externe - Bibliothèque .NET tout-en-un, aucune nécessité d’utiliser le SDK Graph ou des clients tiers.

• Prend en charge .NET Framework & .NET Core / .NET 6+ - Compatible avec les environnements .NET modernes et hérités.

• Déploiement rapide avec une configuration minimale - API facile à utiliser avec du code d’exemple pour une implémentation rapide.

Exemple de code

Découvrez la facilité d’intégrer l’envoi de courriels Microsoft 365 dans votre application .NET grâce au client Graph intégré d’Aspose.Email.

var client = GraphClient.GetClient(authProvider);
var message = new MailMessage(...);
client.Send(message);

Comment ça fonctionne

Microsoft Graph est une API web RESTful qui permet d’accéder aux services Microsoft 365, y compris la capacité d’envoyer des courriels. Lors de l’envoi de courriels via Microsoft Graph, les requêtes sont envoyées en HTTP POST vers le point de terminaison /sendMail, accompagné du corps du message. Ce corps est généralement un objet JSON contenant le contenu du message (destinataires, objet, corps, etc.) et les fichiers joints.

Lors de la réception de la requête, MS Graph la traite et répond avec un code d’état HTTP. Une opération d’envoi réussie renvoie une réponse 202 Accepted, indiquant que le message a été mis en file d’attente pour la livraison. Gérer ces réponses permet aux développeurs d’assurer une communication réussie ou de déboguer tout problème éventuel.

Authentification des requêtes Microsoft Graph

Appeler Microsoft Graph n’est pas aussi simple que d’envoyer une requête HTTP — vous devez d’abord gérer l’authentification. L’API Graph est protégée par Azure Active Directory (Azure AD), ce qui signifie que vous devez obtenir un jeton d’accès avant toute requête. Ce jeton précise les opérations que vous êtes autorisé à effectuer, en fonction des autorisations accordées lors du processus d’authentification.

Pour vous authentifier, vous devez d’abord créer une inscription d’application dans Azure AD, définir les autorisations requises, puis demander un jeton d’accès en utilisant le flux OAuth approprié. Une fois le jeton obtenu, incluez‑le dans le Authorization en‑tête de vos requêtes.

Aspose.Email pour .NET simplifie le processus d’obtention et de gestion du jeton d’accès, garantissant que l’application puisse interagir en toute sécurité avec Microsoft Graph. En implémentant son ITokenProvider interface, les développeurs peuvent récupérer efficacement le jeton OAuth 2.0 requis pour l’authentification. Une fois qu’une inscription d’application a été configurée dans le portail Azure et que les autorisations nécessaires, telles que Mail.Send, ont été accordées, les développeurs peuvent utiliser les fonctionnalités de la bibliothèque pour intégrer des fonctionnalités de messagerie étendues dans leurs applications.

Commencez par quelques étapes essentielles :

1. Enregistrez votre application dans le portail Azure et accordez des autorisations telles que Mail.Send pour l’envoi de courriels.
2. Obtenez un jeton d’accès : implémentez le ITokenProvider interface d’Aspose.Email pour .NET afin de récupérer le jeton OAuth 2.0 requis pour l’authentification.
3. Installez Aspose.Email pour .NET via NuGet ou en téléchargeant son DLL fichier.

En suivant ces étapes, vous serez bien équipé·e pour commencer le codage.

Comprendre les requêtes et réponses Microsoft Graph

Requête : les données telles que l’objet du message, le corps, les détails du destinataire et les pièces jointes sont structurées au format JSON. Lorsque la méthode Send est appelée, ces données sont sérialisées et envoyées via une requête POST vers le point de terminaison /sendMail de Microsoft Graph.

Réponse : la réponse de l’API Graph est renvoyée sous forme de code d’état. Une réponse 202 Accepted indique une transmission réussie, tandis que des codes d’erreur tels que 401 Unauthorized ou 403 Forbidden peuvent indiquer des problèmes d’authentification ou d’autorisations.

La bibliothèque .NET fournit des fonctionnalités intégrées pour former, envoyer des requêtes et analyser les réponses lors de l’interaction avec des services externes comme Microsoft Graph. Ces fonctionnalités permettent aux développeurs de rationaliser la communication avec les services Microsoft 365 (par ex. Outlook, Calendar, Contacts) sans avoir à créer manuellement des requêtes HTTP ou à analyser des réponses JSON brutes.

1. Création de requêtes : Aspose.Email simplifie la création des requêtes en fournissant des classes et méthodes spécifiques qui abstraient la complexité de la formation des requêtes. Par exemple, les développeurs peuvent interagir avec les courriels, les calendriers et les contacts via des API intuitives sans construire manuellement les requêtes Graph requises.

2. Envoi de requêtes : la bibliothèque inclut des mécanismes intégrés pour envoyer des requêtes directement aux services comme Microsoft Graph. Au lieu de gérer manuellement l’authentification et les méthodes HTTP, Aspose.Email gère le processus en arrière‑plan. Cela comprend l’ajout des en‑têtes nécessaires tels que les jetons d’autorisation et les types de contenu, garantissant que la requête est correctement formatée pour une communication réussie avec les services Microsoft.

3. Analyse des réponses : avec la prise en charge de l’analyse des réponses, il peut convertir les réponses JSON ou XML brutes en objets structurés, tels que MailMessage, CalendarEvent ou Contact. Cela élimine le besoin pour les développeurs de gérer directement l’analyse JSON. Les données analysées peuvent être utilisées immédiatement dans l’application, rendant le processus d’intégration plus fluide et efficace.

Ces fonctionnalités permettent aux développeurs de se concentrer davantage sur la logique métier plutôt que sur la gestion des complexités sous‑jacentes de l’interaction avec les services de messagerie.

Exemple complet de code C# pour l’envoi de courriels avec OAuth2 et Aspose.Email

L’exemple suivant montre le processus complet d’envoi d’un courriel en utilisant l’API Graph via Aspose.Email pour .NET. Quelques lignes de code vous permettent de générer un jeton d’accès OAuth2, d’initialiser le client Graph, de composer un message et de l’envoyer :

1. Créez une instance de IGraphClient en appelant GetClient méthode.
2. Initialisez un objet eml de MailMessage classe, définissez ses propriétés.
3. Envoyez le message en utilisant le Envoyer méthode de la bibliothèque.

using Aspose.Email;
using Aspose.Email.Clients.Graph;

// Generate the access token
AccessTokenProvider tokenProvider = new AccessTokenProvider();

// Create a Graph client
IGraphClient client = GraphClient.GetClient(tokenProvider, "tenant ID");

// Create a new message
var eml = new MailMessage(fromAddress, toAddress, subject, body);
   
// Send message
client.Send(eml);

Envoyer des courriels avec pièces jointes

L’envoi de courriels avec pièces jointes via Microsoft Graph est simple et efficace avec la bibliothèque Aspose.Email pour .NET. Les pièces jointes peuvent être de n’importe quel type de fichier, comme des documents, des images ou des PDF, qui sont envoyés avec le message. Cela est particulièrement utile pour partager des ressources comme des rapports, des présentations ou d’autres documents essentiels directement via votre application .NET.

Dans l’extrait de code suivant, les pièces jointes sont ajoutées à l’objet MailMessage avant l’envoi du courriel :

// Add attachments to the message
Attachment attachment = new Attachment("path_to_attachment");
eml.Attachments.Add(attachment);

Comment les pièces jointes sont traitées

1. Chargement des pièces jointes : la pièce jointe est chargée depuis le chemin de fichier spécifié ("path_to_attachment"), qui peut être un fichier local ou un flux. Le Pièce jointe classe vous permet d’ajouter n’importe quel type de fichier comme pièce jointe, offrant une grande flexibilité.
2. Ajout au courriel : une fois la pièce jointe créée, elle est ajoutée au message email en utilisant le Attachments.Add() méthode. Cette méthode ajoute le fichier à la MailMessage collection de pièces jointes de l’objet, qui est automatiquement incluse lorsque le message est envoyé via MS Graph.
3. Envoi du courriel : une fois les pièces jointes ajoutées au message, le Envoyer méthode du IGraphClient interface envoie le courriel avec tous les fichiers attachés.

Gestion de plusieurs pièces jointes

Vous pouvez facilement ajouter plusieurs pièces jointes en répétant le processus pour chaque fichier. Voici comment attacher plus d’un fichier :

Attachment attachment1 = new Attachment("file1.pdf");
Attachment attachment2 = new Attachment("image.png");
eml.Attachments.Add(attachment1);
eml.Attachments.Add(attachment2);

Limites de taille des pièces jointes

Il est important de noter que Microsoft Graph impose des limites de taille pour les messages électroniques. La taille totale d’un courriel, pièces jointes comprises, ne doit pas dépasser 25 Mo. Si vous devez envoyer des fichiers plus volumineux, envisagez de les télécharger sur un service de stockage cloud (comme OneDrive) et d’envoyer le lien du fichier à la place.

Envie d’en savoir plus ? Explorez le support complet de Microsoft Graph

Aspose.Email pour .NET propose une intégration étendue de Microsoft 365 via l’API Graph. Vous pouvez également :

• Gérez les dossiers, les messages et les brouillons

• Travaillez avec les pièces jointes et les catégories

• Gérez les contacts, les événements de calendrier, les cahiers, et plus encore

Explorez l’ensemble Fonctionnalités Microsoft Graph.

Installez l’API .NET

Prenez une minute pour installer la bibliothèque dans votre projet et commencez à créer des solutions de messagerie Microsoft 365 sécurisées et évolutives avec Aspose.Email pour .NET. Choisissez la méthode la plus pratique :

• Utilisez NuGet Gestionnaire de packages
• Référez‑vous aux assemblages
• Ou utilisez simplement la commande suivante dans la console du Gestionnaire de packages de Visual Studio :

PM> Install-Package Aspose.Email