Documentation – Lập trình với Gmail

Net: Cấu hình truy cập API OAuth 2.0 tới các dịch vụ Google

Mon, 01 Jan 0001 00:00:00 +0000

Tạo dự án Google Developer Console để truy cập API

Tạo một dự án trong Google Developer Console là bước quan trọng để truy cập và sử dụng các API của Google cho ứng dụng của bạn. Quá trình này bao gồm thiết lập dự án, đồng ý với các điều khoản, xác minh danh tính và cấu hình các thiết lập API phù hợp với nhu cầu. Các bước sau sẽ hướng dẫn bạn qua quá trình tạo dự án và nhận các thông tin xác thực cần thiết cho các dịch vụ như Calendar và Contacts API.

Các bước tạo dự án trong Google Developer Console

Truy cập liên kết https://cloud.google.com/console/project và đăng nhập bằng thông tin Gmail của bạn

Chọn ô kiểm "I have read and agree to all Terms of Service for the Google Cloud Platform products." và nhấn nút Create

"SMS Verification" sẽ được yêu cầu. Nhấn nút tiếp tục:

Nhập tên quốc gia của bạn và nhập số điện thoại di động. Nhấn nút: Send Verification Code

Nhập mã xác nhận nhận được trên điện thoại của bạn.

Trong danh sách APIs & auth \ APIs, bật trạng thái của Calendar API và Contacts API. Tắt tất cả các API khác.

Trong mục APIs & auth -> Credentials, nhấn nút "CREAET NEW CLIENT ID" trong phần "OAuth". Chọn "Installed application" và "Other" từ các lựa chọn, sau đó nhấn nút "Create Client ID". Ghi lại Client ID và Client Secret ở đây sẽ được sử dụng trong các đoạn mã mẫu trong phần này.

Tích hợp Google OAuth 2.0 bảo mật

Khi làm việc với Google OAuth 2.0 trong Aspose.Email cho .NET, bạn sẽ cần các lớp sau:

GoogleOAuthHelper class - Đơn giản hoá quá trình xác thực người dùng Google và lấy các token cần thiết để tương tác với các API Google, chẳng hạn như Calendar, Contacts và Gmail.
GoogleUser class - Được thiết kế để đóng gói và quản lý thông tin xác thực cần thiết cho người dùng để xác thực và tương tác với các dịch vụ Google, đặc biệt là các API yêu cầu xác thực OAuth 2.0 như Google Calendar.
TokenResponse class - Đây là mô hình được thiết kế để đại diện và xử lý dữ liệu phản hồi từ endpoint token OAuth 2.0, nơi các token truy cập được lấy đổi lấy ủy quyền.

Trong các bài viết sau, bạn sẽ tìm thấy các mẫu mã minh họa cách sử dụng những lớp này trong môi trường .NET để thiết lập tương tác bảo mật với các dịch vụ OAuth 2.0.

Xác thực OAuth 2.0 với Lớp GoogleOAuthHelper

Lớp này xử lý việc tạo URL mã ủy quyền, tạo các thử thách mã, và lấy token truy cập và refresh. Bằng cách sử dụng GoogleOAuthHelper, các nhà phát triển có thể tinh giản luồng OAuth 2.0, đảm bảo giao tiếp an toàn và hiệu quả với các dịch vụ Google. Đoạn mã sau cho bạn thấy cách triển khai GoogleOAuthHelper lớp vào dự án:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Security.Cryptography;
using System.Text;

/// <summary>
/// Developer console:
/// https://console.cloud.google.com/projectselector2
/// Documentation:
/// https://developers.google.com/identity/protocols/oauth2/native-app
/// </summary>
internal class GoogleOAuthHelper
{
    public const string AUTHORIZATION_URL = "https://accounts.google.com/o/oauth2/v2/auth";
    public const string TOKEN_REQUEST_URL = "https://oauth2.googleapis.com/token";

    public const string REDIRECT_URI = "urn:ietf:wg:oauth:2.0:oob";
    public const string REDIRECT_TYPE = "code";

    public static string codeVerifier;
    public static string codeChallenge;

    public static CodeChallengeMethod codeChallengeMethod = CodeChallengeMethod.S256;

    public const string SCOPE =
        "https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcalendar" + // Calendar
        "+" +
        "https%3A%2F%2Fwww.google.com%2Fm8%2Ffeeds%2F" + // Contacts
        "+" +
        "https%3A%2F%2Fmail.google.com%2F"; // IMAP & SMTP

    static GoogleOAuthHelper()
    {
        CreateCodeVerifier();
        CreateCodeChallenge();
    }

    internal static string CreateCodeVerifier()
    {
        string allowedChars = "0123456789AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz-._~";

        const int minLength = 43;
        const int maxLength = 128;

        Random random = new Random();
        int length = minLength + random.Next(maxLength - minLength);
        List<char> codeVerifierChars = new List<char>();

        for (int i = 0; i < length; i++)
        {
            int index = random.Next(allowedChars.Length);
            codeVerifierChars.Add(allowedChars[index]);
        }

        return codeVerifier = string.Join("", codeVerifierChars.ToArray());
    }

    internal static string CreateCodeChallenge()
    {
        if (codeChallengeMethod == CodeChallengeMethod.Plain)
            return codeChallenge = codeVerifier;

        byte[] hashValue = null;
        using (SHA256 sha256 = SHA256.Create())
            hashValue = sha256.ComputeHash(Encoding.ASCII.GetBytes(codeVerifier));

        string b64 = Convert.ToBase64String(hashValue);
        b64 = b64.Split('=')[0];
        b64 = b64.Replace('+', '-');
        b64 = b64.Replace('/', '_');

        return codeChallenge = b64;
    }

    internal static string GetAuthorizationCodeUrl(GoogleUser user)
    {
        return GetAuthorizationCodeUrl(user, SCOPE, REDIRECT_URI, REDIRECT_TYPE);
    }

    internal static string GetAuthorizationCodeUrl(
        GoogleUser user, string scope, string redirectUri, string responseType)
    {
        string state = System.Web.HttpUtility.UrlEncode(Guid.NewGuid().ToString());

        string approveUrl = AUTHORIZATION_URL +
            $"?client_id={user.ClientId}&redirect_uri={redirectUri}&response_type={responseType}&scope={scope}&" +
            $"code_challenge={codeChallenge}&code_challenge_method={codeChallengeMethod.ToString()}&" +
            $"state={state}";

        return approveUrl;
    }

    internal static TokenResponse GetAccessTokenByRefreshToken(GoogleUser user)
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(TOKEN_REQUEST_URL);
        request.CookieContainer = new CookieContainer();
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";

        string clientId = System.Web.HttpUtility.UrlEncode(user.ClientId);
        string clientSecret = System.Web.HttpUtility.UrlEncode(user.ClientSecret);
        string refreshToken = System.Web.HttpUtility.UrlEncode(user.RefreshToken);
        string grantType = System.Web.HttpUtility.UrlEncode("refresh_token");

        string encodedParameters = $"client_id={clientId}&client_secret={clientSecret}&refresh_token={refreshToken}&grant_type={grantType}";

        byte[] requestData = Encoding.UTF8.GetBytes(encodedParameters);
        request.ContentLength = requestData.Length;
        if (requestData.Length > 0)
            using (Stream stream = request.GetRequestStream())
                stream.Write(requestData, 0, requestData.Length);

        HttpWebResponse response = (HttpWebResponse)request.GetResponse();
        string responseText = null;
        using (TextReader reader = new StreamReader(response.GetResponseStream(), Encoding.ASCII))
            responseText = reader.ReadToEnd();

        TokenResponse tokensResponse = JsonConvert.DeserializeObject<TokenResponse>(responseText);

        return tokensResponse;
    }

    internal static TokenResponse GetAccessTokenByAuthCode(string authorizationCode, GoogleUser user)
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(TOKEN_REQUEST_URL);
        request.CookieContainer = new CookieContainer();
        request.Method = "POST";
        request.ContentType = "application/x-www-form-urlencoded";

        string clientId = System.Web.HttpUtility.UrlEncode(user.ClientId);
        string clientSecret = System.Web.HttpUtility.UrlEncode(user.ClientSecret);
        string authCode = System.Web.HttpUtility.UrlEncode(authorizationCode);
        string redirectUri = System.Web.HttpUtility.UrlEncode(REDIRECT_URI);
        string grantType = System.Web.HttpUtility.UrlEncode("authorization_code");

        string encodedParameters = $"client_id={clientId}&client_secret={clientSecret}&code={authCode}&code_verifier={codeVerifier}&redirect_uri={redirectUri}&grant_type={grantType}";

        byte[] requestData = Encoding.UTF8.GetBytes(encodedParameters);
        request.ContentLength = requestData.Length;
        if (requestData.Length > 0)
            using (Stream stream = request.GetRequestStream())
                stream.Write(requestData, 0, requestData.Length);

        HttpWebResponse response = (HttpWebResponse)request.GetResponse();
        string responseText = null;
        using (TextReader reader = new StreamReader(response.GetResponseStream(), Encoding.ASCII))
            responseText = reader.ReadToEnd();

        TokenResponse tokensResponse = JsonConvert.DeserializeObject<TokenResponse>(responseText);

        return tokensResponse;
    }

    public enum CodeChallengeMethod
    {
        S256,
        Plain
    }
}

Google OAuth Helper nên được sử dụng như sau:

Phải tạo URL mã ủy quyền trước.
Mở URL trong trình duyệt và hoàn thành tất cả các thao tác. Kết quả, bạn sẽ nhận được mã ủy quyền.
Sử dụng mã ủy quyền để nhận token làm mới.
Khi token làm mới tồn tại, bạn có thể sử dụng nó để lấy token truy cập.

GoogleUser user = new GoogleUser(email, password, clientId, clientSecret);

string authUrl = GoogleOAuthHelper.GetAuthorizationCodeUrl(user);

Console.WriteLine("Go to the following URL and get your authorization code:");
Console.WriteLine(authUrl);
Console.WriteLine();

Console.WriteLine("Enter the authorization code:");
string authorizationCode = Console.ReadLine();
Console.WriteLine();

TokenResponse tokenInfo = GoogleOAuthHelper.GetAccessTokenByAuthCode(authorizationCode, user);
Console.WriteLine("The refresh token has been received:");
Console.WriteLine(tokenInfo.RefreshToken);
Console.WriteLine();

user.RefreshToken = tokenInfo.RefreshToken;
tokenInfo = GoogleOAuthHelper.GetAccessTokenByRefreshToken(user);
Console.WriteLine("The new access token has been received:");
Console.WriteLine(tokenInfo.AccessToken);
Console.WriteLine();

Lớp GoogleUser cho Xác thực OAuth 2.0

Đoạn mã sau cho bạn thấy cách triển khai GoogleUser lớp:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

public class GoogleUser
{
    public GoogleUser(string email, string password, string clientId, string clientSecret)
        : this(email, password, clientId, clientSecret, null)
    {
    }

    public GoogleUser(string email, string password, string clientId, string clientSecret, string refreshToken)
    {
        Email = email;
        Password = password;
        ClientId = clientId;
        ClientSecret = clientSecret;
        RefreshToken = refreshToken;
    }

    public readonly string Email;
    public readonly string Password;
    public readonly string ClientId;
    public readonly string ClientSecret;

    public string RefreshToken;
}

Xác thực với OAuth 2.0 bằng lớp TokenResponse

Đoạn mã sau cho bạn thấy cách TokenResponse có thể triển khai lớp:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

using Newtonsoft.Json;

public class TokenResponse
{
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "access_token", Required = Required.Default)]
    public string AccessToken { get; set; }

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "token_type", Required = Required.Default)]
    public string TokenType { get; set; }

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "expires_in", Required = Required.Default)]
    public int ExpiresIn { get; set; }

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "refresh_token", Required = Required.Default)]
    public string RefreshToken { get; set; }

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "scope", Required = Required.Default)]
    public string Scope { get; set; }
}

Net: Quản lý Google Calendar trong Ứng dụng .NET

Mon, 01 Jan 0001 00:00:00 +0000

Thêm, Chỉnh sửa và Xóa Lịch Gmail

Aspose.Email cho phép các ứng dụng quản lý các lịch Gmail bằng cách sử dụng IGmailClient cung cấp các tính năng như thêm, xóa và cập nhật lịch Gmail. Lớp client này trả về một danh sách các đối tượng kiểu ExtendedCalendar chứa thông tin về các mục lịch Gmail. IGmailClient lớp cung cấp các hàm sau cho lịch:

CreateCalendar Nó có thể được dùng để chèn lịch mới
ListCalendars Nó có thể được dùng để lấy danh sách tất cả các lịch của một client
DeleteCalendar Nó có thể được dùng để xóa một lịch
FetchCalendar Nó có thể được dùng để lấy lịch cụ thể của một khách hàng
UpdateCalendar Hàm này được dùng để chèn lại lịch đã chỉnh sửa của một client

Để Truy cập các lịch, GoogleTestUser được khởi tạo bằng thông tin đăng nhập tài khoản gmail. GoogleOAuthHelper được sử dụng để lấy token truy cập cho người dùng, sau đó token này được dùng để khởi tạo IGmailClient.

Chèn, Lấy và Cập nhật Lịch Gmail

Đối với việc chèn một lịch, khởi tạo một đối tượng kiểu Calendar và chèn nó bằng cách sử dụng CreateCalendar() hàm. CreateCalendar() trả về id của lịch mới được chèn. Id này có thể được dùng để lấy lịch từ máy chủ. Đoạn mã sau cho bạn thấy cách chèn, lấy và cập nhật lịch.

Xóa Lịch Google Cụ thể

Để xóa một lịch cụ thể, chúng ta cần lấy danh sách tất cả các lịch của một khách hàng và sau đó xóa theo yêu cầu. ListCalendars() trả về danh sách của ExtendedCalendar chứa các lịch Gmail. Đoạn mã sau cho bạn thấy cách xóa một lịch cụ thể.

Kiểm soát Truy cập Lịch

Aspose.Email cung cấp quyền kiểm soát đầy đủ đối với việc truy cập các mục lịch. ListAccessRules() hàm được công khai bởi IGmailClient trong đó trả về danh sách của AccessControlRule. Thông tin quy tắc cá nhân có thể được lấy, chỉnh sửa và lưu lại cho lịch của một khách hàng. IGmailClient chứa các hàm sau để quản lý các quy tắc kiểm soát truy cập.

ListAccessRules Hàm này cung cấp danh sách AccessControlRule
CreateAccessRule Hàm này tạo một quy tắc truy cập mới cho lịch.
UpdateAccessRule Hàm này được dùng để cập nhật một quy tắc truy cập.
FetchAccessRule Nó có thể được dùng để lấy quy tắc truy cập cụ thể cho lịch của một khách hàng
DeleteAccessRule Hàm này được dùng để xóa một quy tắc truy cập.

Đoạn mã dưới đây cho bạn thấy cách sử dụng các hàm để quản lý các quy tắc truy cập:

Cài đặt Client Lịch và Thông tin Màu

Aspose.Email hỗ trợ truy cập cài đặt Khách hàng bằng cách sử dụng IGmailClient.GetSettings(). Nó trả về danh sách các thiết lập như dưới đây:

dateFieldOrder
displayAllTimezones
hideInvitations
format24HourTime
defaultCalendarMode
defaultEventLength
locale
remindOnRespondedEventsOnly
alternateCalendar
userLocation
hideWeekends
showDeclinedEvents
weekStart
weather
customCalendarMode
timezoneLabel
timezone
useKeyboardShortcuts
quốc gia

Tương tự, thông tin màu cho khách hàng cũng có thể được lấy bằng cách sử dụng IGmailClient.GetColors(). Đối tượng thông tin màu này trả về danh sách các màu tiền cảnh, màu nền và ngày giờ cập nhật.

Truy cập Cài đặt Khách hàng

Đoạn mã dưới đây cho bạn thấy cách các hàm có thể được sử dụng để truy cập các thiết lập của client:

Truy cập Thông tin Màu

Đoạn mã dưới đây cho bạn thấy cách các hàm có thể được sử dụng để truy cập các cài đặt màu của client.

Quản lý Cuộc hẹn Lịch Google

Aspose.Email cung cấp các tính năng để làm việc với Cuộc hẹn trong lịch Google. Các tác vụ sau có thể được thực hiện trên các cuộc hẹn trong lịch Google:

Thêm các cuộc hẹn.
Lấy danh sách các cuộc hẹn.
Lấy thông tin cuộc hẹn cụ thể.
Cập nhật một cuộc hẹn.
Di chuyển cuộc hẹn từ lịch này sang lịch khác.
Xóa cuộc hẹn.

IGmailClient cung cấp các hàm như CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment và DeleteAppointment.

Thêm Cuộc hẹn vào Google Calendar

Mẫu mã dưới đây minh họa tính năng thêm một cuộc hẹn vào lịch. Để thực hiện, làm theo các bước:

Tạo và chèn một lịch.
Lấy danh sách các cuộc hẹn từ một lịch mới.
Tạo một cuộc hẹn.
Chèn một cuộc hẹn.

Lấy và Cập nhật Cuộc hẹn Lịch Google

Ở đây việc lấy và cập nhật lịch được minh họa như sau:

Lấy cuộc hẹn cụ thể.
Sửa đổi cuộc hẹn.
Cập nhật cuộc hẹn trong lịch.

Giả sử rằng một lịch có id "calendarId" và một cuộc hẹn có id duy nhất "AppointmentUniqueId" đã được trích xuất. Đoạn mã sau cho bạn thấy cách lấy và cập nhật một cuộc hẹn.

Di chuyển và Xóa Cuộc hẹn trong Lịch Google

Cuộc hẹn có thể được di chuyển bằng cách cung cấp lịch nguồn, lịch đích và id duy nhất của cuộc hẹn trong lịch nguồn. Đoạn mã sau cho bạn thấy cách di chuyển và xóa một cuộc hẹn.

Truy vấn FreeBusy cho Lịch Google

Aspose.Email cung cấp cơ chế truy vấn để kiểm tra xem một cuộc hẹn có đến hạn hay không theo tiêu chí. Lớp FreebusyQuery được cung cấp cho mục đích này, cho phép chuẩn bị một truy vấn cho một lịch cụ thể.

Ví dụ mã này trình bày tính năng truy vấn lịch. Các tác vụ sau được thực hiện trong mẫu này:

Tạo và chèn một lịch
Tạo một cuộc hẹn
Chèn cuộc hẹn
Chuẩn bị một FreeBusyQuery
Lấy FreebusyResponse

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

// Use the GoogleUser and GoogleOAuthHelper classes below to receive an access token
using (IGmailClient client = GmailClient.GetInstance(accessToken, user.Email))
{
    // Initialize calendar item
    Aspose.Email.Clients.Google.Calendar calendar1 = new Aspose.Email.Clients.Google.Calendar("summary - " + Guid.NewGuid().ToString(), null, null, "Europe/Kiev");

    // Insert calendar and get back id of newly inserted calendar and Fetch the same calendar using calendar id
    string id = client.CreateCalendar(calendar1);
    Aspose.Email.Clients.Google.Calendar cal1 = client.FetchCalendar(id);
    string calendarId1 = cal1.Id;
    try
    {
        // Get list of appointments in newly inserted calendar. It should be zero
        Appointment[] appointments = client.ListAppointments(calendarId1);
        if (appointments.Length != 0)
        {
            Console.WriteLine("Wrong number of appointments");
            return;
        }

        // Create a new appointment and Calculate appointment start and finish time
        DateTime startDate = DateTime.Now;
        DateTime endDate = startDate.AddHours(1);

        // Create attendees list for appointment
        MailAddressCollection attendees = new MailAddressCollection();
        attendees.Add("user1@domain.com");
        attendees.Add("user2@domain.com");

        // Create appointment
        Appointment app1 = new Appointment("Location - " + Guid.NewGuid().ToString(), startDate, endDate, "user2@domain.com", attendees);
        app1.Summary = "Summary - " + Guid.NewGuid().ToString();
        app1.Description = "Description - " + Guid.NewGuid().ToString();
        app1.StartTimeZone = "Europe/Kiev";
        app1.EndTimeZone = "Europe/Kiev";

        // Insert the newly created appointment and get back the same in case of successful insertion
        Appointment app2 = client.CreateAppointment(calendarId1, app1);

        // Create Freebusy query by setting min/max timeand time zone
        FreebusyQuery query = new FreebusyQuery();
        query.TimeMin = DateTime.Now.AddDays(-1);
        query.TimeMax = DateTime.Now.AddDays(1);
        query.TimeZone = "Europe/Kiev";

        // Set calendar item to search and Get the reponse of query containing 
        query.Items.Add(cal1.Id);
        FreebusyResponse resp = client.GetFreebusyInfo(query);
        // Delete the appointment
        client.DeleteAppointment(calendarId1, app2.UniqueId);
    }
    finally
    {
        // Delete the calendar
        client.DeleteCalendar(cal1.Id);
    }
}

Net: Quản lý Liên hệ Google trong Ứng dụng .NET

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email hỗ trợ làm việc với danh bạ Gmail. Sử dụng IGmailClient Giao diện, người dùng có thể lấy liên hệ từ tài khoản Gmail, tạo liên hệ mới, và cập nhật cũng như xóa các liên hệ hiện có. Gmail cho phép các nhà phát triển thực hiện tất cả những việc này bằng API công khai của nó. Thông tin người dùng cần thiết để làm việc với liên hệ Gmail: Tên người dùng, địa chỉ email, mật khẩu, client ID, client secret, refresh token. Bài viết này cho thấy cách:

Truy cập Danh bạ Gmail

Dưới đây là một ứng dụng mẫu có thể được sử dụng để truy cập chi tiết liên hệ trong tất cả các nhóm.

Tạo Liên hệ Google

Đoạn mã sau cho bạn thấy cách tạo một liên hệ trong Gmail.

Cập nhật Liên hệ Google

Sau khi một liên hệ được lấy, các thuộc tính của nó có thể được cập nhật và liên hệ có thể được lưu lại vào tài khoản Gmail. Đoạn mã sau cho bạn thấy cách lấy liên hệ từ tài khoản Gmail và sau đó chỉnh sửa một trong số chúng rồi lưu lại.

Xóa Liên hệ Google

Để xóa một liên hệ Gmail, client Gmail DeleteContact phương thức được sử dụng như trong đoạn mẫu dưới đây.

Lưu Liên hệ Google

Aspose.Email cho phép lưu liên hệ vào nhiều định dạng đầu ra như MSG và VCF. Lưu phương thức cung cấp khả năng thực hiện việc này. Đoạn mã sau cho bạn thấy cách lưu một liên hệ.

Net: Gửi, Nhận và Quản lý Email Gmail qua SMTP, IMAP và POP3

Mon, 01 Jan 0001 00:00:00 +0000

Hướng dẫn này minh họa cách kết nối tới máy chủ Gmail và thực hiện các thao tác email phổ biến như gửi, nhận và quản lý tin nhắn bằng Aspose.Email cho .NET. Bạn sẽ học cách làm việc với các giao thức SMTP, IMAP và POP3 qua SSL.

Gửi Email qua máy chủ Gmail SMTP

Kết nối tới máy chủ Gmail SMTP

Để gửi email qua Gmail sử dụng giao thức SMTP, tạo một thể hiện của SmtpClient lớp và cấu hình các thuộc tính kết nối của nó, bao gồm địa chỉ máy chủ, số cổng, thông tin xác thực và các tùy chọn bảo mật như được mô tả trong mẫu mã dưới đây.

Gửi một Tin nhắn Email

Khi kết nối đã được cấu hình, bạn có thể gửi email bằng cách tạo một MailMessage đối tượng và truyền nó tới SmtpClient.Send() phương thức.

Mẫu mã dưới đây minh họa cách tạo một tin nhắn email, thiết lập các thuộc tính của nó, ví dụ như tiêu đề, người nhận và nội dung, và gửi nó bằng Aspose.Email trong C#.

Quản lý Email bằng Giao thức IMAP

Phần này chỉ ra cách thực hiện một số thao tác IMAP như kết nối tới tài khoản Gmail, truy cập thư mục, lấy tin nhắn và tạo thư mục trên máy chủ.

Kết nối tới Máy chủ IMAP

Để kết nối tới Gmail qua IMAP, sử dụng ImapClient lớp và chỉ định máy chủ, cổng và thông tin xác thực. Gmail sử dụng cổng 993 cho các kết nối IMAP bảo mật.

Mẫu mã dưới đây minh họa cách tạo và cấu hình một ImapClient để kết nối an toàn tới máy chủ Gmail IMAP:

Chọn Thư mục và Lấy Số lượng Tin nhắn

Bạn có thể truy cập thư mục Inbox và lấy tổng số tin nhắn bằng Aspose.Email SelectFolder phương thức như được mô tả trong mẫu mã dưới đây:

Lưu Tin nhắn về Máy tính

Sau khi chọn một thư mục, sử dụng ListMessages() phương thức để lấy tất cả bản tóm tắt tin nhắn, sau đó tải xuống và lưu mỗi tin nhắn dưới dạng tệp EML. Mẫu mã dưới đây minh họa cách thực hiện nhiệm vụ này:

Tạo Thư mục Mới

IMAP cho phép bạn tạo thư mục trực tiếp trên máy chủ email. Với Aspose.Email, bạn có thể thực hiện chỉ với một dòng lệnh:

Thêm Tin nhắn Mới vào Thư mục

Bạn có thể tạo và chèn một tin nhắn vào một thư mục cụ thể bằng cách sử dụng MailMessage và ImapClient các lớp.

Mẫu mã dưới đây tạo một MailMessage với người gửi, người nhận, tiêu đề và nội dung. Sau đó, nó chọn thư mục Inbox trên máy chủ IMAP, đăng ký thư mục này nếu chưa đăng ký, và cuối cùng chèn tin nhắn đã tạo vào thư mục đã chọn.

Lấy Email bằng Giao thức POP3

Phần này minh họa cách kết nối tới tài khoản Gmail qua POP3, kiểm tra thông tin hộp thư và tải tin nhắn một cách an toàn bằng SSL.

Kết nối tới Máy chủ POP3

Tạo và cấu hình một Pop3client thể hiện để kết nối tới máy chủ Gmail POP3. Sử dụng cổng 995 cho các kết nối SSL. Quy trình được thể hiện trong mẫu mã dưới đây.

Kiểm tra Trạng thái Hộp thư

Sử dụng GetMailboxInfo() phương thức để kiểm tra số lượng tin nhắn và tổng kích thước hộp thư như được mô tả trong mẫu mã dưới đây.

Lấy Thông tin Tin nhắn

Để lấy thông tin về tất cả các tin nhắn trong hộp thư, sử dụng ListMessages() phương thức. Mẫu mã dưới đây lấy một tập hợp siêu dữ liệu tin nhắn bằng cách sử dụng ListMessages(), sau đó lặp qua từng đối tượng thông tin tin nhắn để hiển thị các chi tiết quan trọng như ID duy nhất của tin nhắn, chỉ mục thứ tự, tiêu đề và kích thước. Điều này cho phép client xem trước bản tóm tắt tin nhắn mà không cần tải xuống toàn bộ nội dung email.

Lấy và Lưu Tin nhắn

Sử dụng FetchMessage() phương thức để lấy tin nhắn từng cái một và lưu chúng cục bộ dưới dạng tệp .eml.

Net: Hỗ trợ Gmail API với Aspose.Email cho .NET

Mon, 01 Jan 0001 00:00:00 +0000

Bắt đầu với IGmailClient

Aspose.Email cho .NET cung cấp hỗ trợ mạnh mẽ để tương tác với Gmail qua IGmailClient giao diện. Bạn có thể quản lý tin nhắn và bộ lọc trong hộp thư Gmail — bao gồm liệt kê, lấy, gửi, thêm và xóa email, cũng như quản lý các bộ lọc tùy chỉnh để phân loại tự động.

Để sử dụng các tính năng Gmail, bạn cần khởi tạo một thể hiện IGmailClient bằng clientId, clientSecret, refreshToken và địa chỉ email mục tiêu của bạn. Tất cả các ví dụ dưới đây giả định cấu hình này:

using (IGmailClient client = GmailClient.GetInstance(clientId, clientSecret, refreshToken, email))
{
    // Work with messages or filters
}

Liệt kê Tin nhắn trong Hộp thư Gmail

Lấy tất cả tin nhắn từ hộp thư dưới dạng nhẹ GmailMessageInfo đối tượng. Đoạn mã mẫu dưới đây trình bày cách lấy danh sách các tin nhắn có sẵn trong hộp thư Gmail mà không tải toàn bộ nội dung:

var messages = client.ListMessages();

Lấy và Xóa Tin nhắn Gmail

Đoạn mã mẫu dưới đây minh họa cách đọc và xóa tin nhắn từ Gmail bằng cách sử dụng các định danh duy nhất của chúng:

Sử dụng client.ListMessages() để lấy danh sách các tin nhắn.
Thiết lập vòng lặp for để lặp qua ba tin nhắn đầu tiên.
Trong vòng lặp, lấy mỗi tin nhắn bằng cách sử dụng client.FetchMessage(messages[i].Id).
In tiêu đề và nội dung của tin nhắn đã lấy.
Gọi client.DeleteMessage(messages[i].Id, true) để xóa tin nhắn và chuyển nó vào thùng rác.
Xác nhận xóa với tin nhắn.

var messages = client.ListMessages();

for (int i = 0; i < 3; i++)
{
    var msg = client.FetchMessage(messages[i].Id);
    Console.WriteLine($"Message {i + 1}: Subject - {msg.Subject}, Body - {msg.Body}");

    client.DeleteMessage(messages[i].Id, true);
    Console.WriteLine($"Message {i + 1} moved to trash.");
}

Gửi Tin nhắn qua Gmail

Soạn và gửi email, bao gồm cả tệp đính kèm bằng phương thức SendMessage(). Đoạn mã mẫu dưới đây minh họa cách gửi email qua Gmail kèm tệp đính kèm:

MailMessage message = new MailMessage("sender@example.com", "recipient@example.com", "Weekly Report", "Attached is the weekly report.");

string attachmentPath = Path.Combine(TestUtil.GetTestDataPath(), "report.pdf");
message.Attachments.Add(new Attachment(attachmentPath));

string messageId = client.SendMessage(message);
Console.WriteLine($"Message with attachment sent! ID: {messageId}");