Com enviar correus electrònics fent servir Microsoft 365 Graph API a aplicacions .NET

Envieu un correu electrònic en C# amb Microsoft 365 Graph API

Integrar l’API Microsoft Graph a aplicacions .NET permet als desenvolupadors optimitzar el procés d’enviament de missatges a través dels serveis Microsoft 365. Aspose.Email per a .NET simplifica aquest procés, oferint funcions millorades com la gestió d’adjunts, seguiment i comunicació segura. La biblioteca us permet crear i lliurar comunicacions de correu electrònic personalitzades i d’alt rendiment directament des de les vostres aplicacions .NET.

Avantatges clau d’utilitzar Aspose.Email amb Microsoft Graph

• No es requereix SMTP ni autenticació bàsica - Utilitzeu autenticació segura basada en tokens (OAuth2).

• Integració amb Microsoft 365 i Outlook - Connecteu fàcilment a bústies i serveis de Microsoft 365.

• Llest per a empreses per a desenvolupadors .NET - Dissenyat per a escalabilitat, fiabilitat i fluxos de treball de correu corporatis.

• API totalment gestionada - Sense dependències externes - Biblioteca .NET tot-en-un, sense necessitat del Graph SDK o clients de tercers.

• Suporta .NET Framework i .NET Core / .NET 6+ - Compatible amb entorns .NET moderns i heretats.

• Desplegament ràpid amb configuració mínima - API fàcil d’utilitzar amb codi d’exemple per a una implementació ràpida.

Mostra de codi

Experimenta la facilitat d’integrar l’enviament de correu Microsoft 365 a la teva aplicació .NET amb el client Graph integrat d’Aspose.Email.

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

Com funciona

Microsoft Graph és una API web RESTful que permet l’accés als serveis de Microsoft 365, inclosa la capacitat d’enviar correus electrònics. Quan s’envien correus electrònics mitjançant Microsoft Graph, les sol·licituds s’envien amb HTTP POST a l’endpoint /sendMail, juntament amb la càrrega del missatge. Aquesta càrrega és habitualment un objecte JSON que conté el contingut del missatge (destinataris, assumpte, cos, etc.) i qualsevol fitxer adjunt.

En rebre la sol·licitud, MS Graph la processa i respon amb un codi d’estat HTTP. Una operació d’enviament correcta retorna una resposta 202 Accepted, indicant que el missatge ha estat posat a la cua per a la entrega. Gestionar aquestes respostes permet als desenvolupadors garantir una comunicació exitosa o depurar qualsevol problema que pugui sorgir.

Autenticació de sol·licituds Microsoft Graph

Cridar Microsoft Graph no és tan senzill com enviar una sol·licitud HTTP—primer cal gestionar l’autenticació. L’API Graph està protegida per Azure Active Directory (Azure AD), cosa que significa que heu d’obtenir un token d’accés abans de fer qualsevol sol·licitud. Aquest token d’accés especifica quines operacions podeu realitzar, segons els permisos concedits durant el procés d’autenticació.

Per autenticar‑se, primer heu de configurar un registre d’aplicació a Azure AD, definir els permisos necessaris i, a continuació, sol·licitar un token d’accés utilitzant el flux OAuth adequat. Un cop tingueu el token, incloeu‑lo a l’ Authorization encapçalament de les vostres sol·licituds.

Aspose.Email per a .NET simplifica el procés d’obtenció i gestió del token d’accés, assegurant que l’aplicació pugui interactuar de manera segura amb Microsoft Graph. Implementant el seu ITokenProvider interfície, els desenvolupadors poden obtenir de manera eficient el token OAuth 2.0 requerit per a l’autenticació. Un cop s’ha configurat el registre d’aplicació al portal Azure i s’han concedit els permisos necessaris, com Mail.Send, els desenvolupadors poden utilitzar les funcionalitats de la biblioteca per incorporar àmplies funcionalitats de correu electrònic a les seves aplicacions.

Comenceu amb alguns passos essencials:

1. Registreu la vostra aplicació al portal Azure i concediu permisos com ara Mail.Send per enviar correus electrònics.
2. Obteniu un token d’accés: implementeu el ITokenProvider interfície d’Aspose.Email per a .NET per obtenir el token OAuth 2.0 requerit per a l’autenticació.
3. Instal·leu Aspose.Email per a .NET via NuGet o descarregant el seu DLL fitxer.

Seguint aquests passos estareu ben preparats per començar a programar.

Entenent la sol·licitud i resposta de Microsoft Graph

Sol·licitud: Les dades com l’assumpte del missatge, cos, detalls del destinatari i adjunts, estan estructurades en format JSON. Quan es crida el mètode Send, aquestes dades es serialitzen i s’envien com a sol·licitud POST a l’endpoint Microsoft Graph /sendMail.

Resposta: La resposta de l’API Graph es retorna com a codi d’estat. Una resposta 202 Accepted indica una transmissió correcta, mentre que codis d’error com 401 Unauthorized o 403 Forbidden poden suggerir problemes d’autenticació o permisos.

La biblioteca .NET ofereix funcions integrades per formar, enviar sol·licituds i analitzar respostes quan s’interactua amb serveis externs com Microsoft Graph. Aquestes funcionalitats permeten als desenvolupadors agilitzar la comunicació amb els serveis Microsoft 365 (p. ex., Outlook, Calendar, Contacts) sense necessitat de crear manualment sol·licituds HTTP o analitzar respostes JSON en brut.

1. Formació de sol·licituds: Aspose.Email simplifica la creació de sol·licituds proporcionant classes i mètodes específics que abstracten la complexitat de la formació de peticions. Per exemple, els desenvolupadors poden interactuar amb correus, calendaris i contactes mitjançant APIs intuïtives sense haver de construir manualment les sol·licituds Graph requerides.

2. Enviament de sol·licituds: La biblioteca inclou mecanismes integrats per enviar sol·licituds directament a serveis com Microsoft Graph. En comptes de gestionar manualment l’autenticació i els mètodes HTTP, Aspose.Email gestiona el procés en segon pla. Això inclou afegir les capçaleres necessàries, com tokens d’autorització i tipus de contingut, assegurant que la sol·licitud estigui correctament formatada per a una comunicació exitosa amb els serveis Microsoft.

3. Anàlisi de respostes: Amb suport per a l’anàlisi de respostes, pot convertir respostes JSON o XML en brut en objectes estructurats, com MailMessage, CalendarEvent o Contact. Això elimina la necessitat que els desenvolupadors gestionin l’anàlisi de JSON directament. Les dades analitzades es poden utilitzar immediatament dins de l’aplicació, fent que el procés d’integració sigui més fluid i eficient.

Aquestes funcions permeten als desenvolupadors centrar-se més en la lògica de negoci en comptes de gestionar les complexitats subjacents d’interactuar amb els serveis de correu.

Exemple complet de codi C# per enviar correus electrònics amb OAuth2 i Aspose.Email

L’exemple següent mostra el procés complet d’enviament d’un correu electrònic utilitzant l’API Graph a través d’Aspose.Email per a .NET. unes poques línies de codi us permeten generar un token d’accés OAuth2, inicialitzar el client Graph, composar un missatge i enviar‑lo:

1. Crea una instància de IGraphClient cridant GetClient mètode.
2. Inicialitzeu un objecte eml de MailMessage classe, establiu les seves propietats.
3. Envia el missatge utilitzant el Envia mètode de la biblioteca.

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);

Envia correus electrònics amb adjunts

Enviar correus electrònics amb adjunts a través de Microsoft Graph és senzill i eficient amb la biblioteca Aspose.Email per a .NET. Els adjunts poden ser qualsevol tipus de fitxer, com documents, imatges o PDF, que s’envien juntament amb el missatge de correu. Això és especialment útil per compartir recursos com informes, presentacions o altres documents vitals directament des de la vostra aplicació .NET.

En el fragment de codi següent, s’afegeixen adjunts a l’objecte MailMessage abans d’enviar el correu electrònic:

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

Com es processen els adjunts

1. Carregant adjunts: L’adjunt es carrega des del camí de fitxer especificat ("path_to_attachment"), que pot ser un fitxer local o un flux. El Adjunt classe us permet afegir qualsevol tipus de fitxer com a adjunt, fent-lo molt flexible.
2. Afegint al correu: Un cop creat l’adjunt, s’afegeix al missatge de correu utilitzant el Attachments.Add() mètode. Aquest mètode afegeix el fitxer a la MailMessage col·lecció d’adjunts de l’objecte, que s’inclou automàticament quan el missatge s’envia a través de MS Graph.
3. Enviament del correu: Un cop s’han afegit els adjunts al missatge, el Envia mètode del IGraphClient interfície envia el correu amb tots els fitxers adjunts.

Gestió de múltiples adjunts

Podeu afegir fàcilment diversos adjunts repetint el procés per a cada fitxer. Aquí us mostrem com adjuntar més d’un fitxer:

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

Límits de mida d’adjunt

És important tenir en compte que Microsoft Graph imposa límits de mida per als missatges de correu. La mida total d’un correu, inclosos els adjunts, no pot superar els 25 MB. Si necessiteu enviar fitxers més grans, considereu pujar-los a un servei d’emmagatzematge al núvol (com OneDrive) i enviar el enllaç del fitxer en canvi.

Voleu més? Exploreu el suport complet de Microsoft Graph

Aspose.Email per a .NET ofereix una integració ampliada de Microsoft 365 a través de l’API Graph. També podeu:

• Gestiona carpetes, missatges i esborranys

• Treballa amb adjunts i categories

• Gestioneu contactes, esdeveniments de calendari, blocs de notes i més

Exploreu el complet Funcionalitats de Microsoft Graph.

Instal·leu l'API .NET

Dediqueu un minut a instal·lar la biblioteca al vostre projecte i comenceu a crear solucions segures i escalables de correu Microsoft 365 amb Aspose.Email per a .NET. Trieu la manera més convenient:

• Utilitza NuGet Gestor de paquets
• Feu referència al requerit assemblies
• O simplement useu la següent ordre dins de la consola del Gestor de Paquets a Visual Studio:

PM> Install-Package Aspose.Email