Documentation – Програмування з Gmail

Net: Налаштування доступу OAuth 2.0 API до сервісів Google

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

Створення проекту в Google Developer Console для доступу до API

Створення проекту в Google Developer Console є важливим кроком для доступу та використання Google API у ваших додатках. Цей процес включає налаштування проекту, згоду з умовами, підтвердження особи та налаштування параметрів API відповідно до ваших потреб. Наступні кроки проведуть вас процесом створення проекту та отримання необхідних облікових даних для сервісів, таких як Calendar і Contacts API.

Кроки для створення проекту в Google Developer Console

Перейдіть за посиланням https://cloud.google.com/console/project і увійдіть, використовуючи облікові дані Gmail

Відмітьте прапорець "I have read and agree to all Terms of Service for the Google Cloud Platform products." і натисніть кнопку Create

"SMS Verification" буде запитано. Натисніть кнопку продовжити:

Введіть назву вашої країни та номер мобільного. Натисніть кнопку: Send Verification Code

Введіть код підтвердження, отриманий на вашому мобільному.

У списку APIs & auth \ APIs увімкніть Calendar API та Contacts API. Вимкніть усі інші.

У розділі APIs & auth -> Credentials натисніть кнопку "CREAET NEW CLIENT ID" у секції "OAuth". Виберіть "Installed application" та "Other" зі списку, і натисніть кнопку "Create Client ID". Запишіть тут Client ID та Client Secret, які будуть використані у прикладах коду в цьому розділі.

Безпечна інтеграція Google OAuth 2.0

Працюючи з Google OAuth 2.0 в Aspose.Email для .NET, вам знадобляться наступні класи:

GoogleOAuthHelper class - Спрощує процес автентифікації користувача Google та отримання необхідних токенів для взаємодії з API Google, такими як Calendar, Contacts і Gmail.
GoogleUser class - Призначений для інкапсуляції та управління обліковими даними, необхідними користувачеві для автентифікації та взаємодії зі службами Google, зокрема API, які вимагають автентифікації OAuth 2.0, такі як Google Calendar.
TokenResponse class - Це модель, створена для представлення та обробки даних відповіді з токен-ендпоінту OAuth 2.0, де токени доступу отримуються в обмін на авторизацію.

У наступних статтях ви знайдете приклади коду, які демонструють, як використовувати ці класи у середовищі .NET для встановлення безпечної взаємодії з сервісами OAuth 2.0.

Автентифікація OAuth 2.0 за допомогою класу GoogleOAuthHelper

Клас обробляє створення URL коду авторизації, генерацію челенджів коду та отримання токенів доступу і оновлення. Використовуючи GoogleOAuthHelper, розробники можуть оптимізувати процес OAuth 2.0, забезпечуючи безпечну та ефективну взаємодію зі службами Google. Нижченаведений фрагмент коду показує, як реалізувати GoogleOAuthHelper клас у проекті:

// 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 слід використовувати так:

Спочатку треба згенерувати URL коду авторизації.
Відкрийте URL у браузері та виконайте всі дії. В результаті ви отримаєте код авторизації.
Використайте код авторизації, щоб отримати токен оновлення.
Коли існує токен оновлення, його можна використати для отримання токенів доступу.

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

Клас GoogleUser для автентифікації OAuth 2.0

Нижченаведений фрагмент коду показує, як реалізувати GoogleUser клас:

// 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;
}

Автентифікація за допомогою OAuth 2.0 з використанням класу TokenResponse

Нижченаведений фрагмент коду показує, як TokenResponse Клас можна реалізувати:

// 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: Керування Google Calendar у застосунках .NET

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

Додавання, редагування та видалення календарів Gmail

Aspose.Email дозволяє застосункам керувати календарями Gmail за допомогою IGmailClient який забезпечує функції додавання, видалення та оновлення календарів Gmail. Цей клієнтський клас повертає список об’єктів типу ExtendedCalendar, які містять інформацію про елементи календаря Gmail. IGmailClient клас надає наступні функції для календарів:

CreateCalendar Вона може бути використана для вставки нового календаря
ListCalendars Вона може бути використана для отримання списку всіх календарів клієнта
DeleteCalendar Її можна використати для видалення календаря
FetchCalendar Її можна використати для отримання конкретного календаря клієнта
UpdateCalendar Ця функція використовується для повторного вставлення зміненого календаря клієнта

Для доступу до календарів GoogleTestUser ініціалізується за допомогою облікових даних облікового запису Gmail. GoogleOAuthHelper використовується для отримання токену доступу користувача, який потім використовується для ініціалізації IGmailClient.

Вставка, отримання та оновлення календарів Gmail

Для вставки календаря ініціалізуйте об’єкт типу Calendar і вставте його за допомогою CreateCalendar() функція. CreateCalendar() повертає ідентифікатор ново вставленого календаря. Цей ідентифікатор можна використати для отримання календаря з сервера. Наступний фрагмент коду показує, як вставити, отримати та оновити календар.

Видалення конкретних календарів Google

Для видалення конкретного календаря нам потрібно отримати список усіх календарів клієнта, а потім видалити потрібний. ListCalendars() повертає список ExtendedCalendar яка містить календарі Gmail. Наступний фрагмент коду показує, як видалити конкретний календар.

Контроль доступу до календаря

Aspose.Email забезпечує повний контроль над доступом до елементів календаря. ListAccessRules() функція доступна через IGmailClient яка повертає список AccessControlRule. Інформацію про окреме правило можна отримати, змінити та зберегти назад для календаря клієнта. IGmailClient містить наступні функції для керування правилами контролю доступу.

ListAccessRules Ця функція надає список AccessControlRule
CreateAccessRule Ця функція створює нове правило доступу для календаря.
UpdateAccessRule Ця функція використовується для оновлення правила доступу.
FetchAccessRule Її можна використати для отримання конкретного правила доступу для календаря клієнта
DeleteAccessRule Ця функція використовується для видалення правила доступу.

Наведений нижче кодовий фрагмент показує, як використовувати функції для керування правилами доступу:

Налаштування клієнта календаря та інформація про кольори

Aspose.Email підтримує доступ до налаштувань клієнта за допомогою IGmailClient.GetSettings(). Вона повертає список налаштувань, як наведено нижче:

dateFieldOrder
displayAllTimezones
hideInvitations
format24HourTime
defaultCalendarMode
defaultEventLength
locale
remindOnRespondedEventsOnly
alternateCalendar
userLocation
hideWeekends
showDeclinedEvents
weekStart
weather
customCalendarMode
timezoneLabel
timezone
useKeyboardShortcuts
country

Подібну інформацію про кольори для клієнтів також можна отримати за допомогою IGmailClient.GetColors(). Цей об’єкт інформації про колір повертає список кольорів переднього плану, кольорів фону та дату і час оновлення.

Доступ до налаштувань клієнта

Наведений нижче кодовий фрагмент показує, як можна використовувати функції для доступу до налаштувань клієнта:

Доступ до інформації про кольори

Наведений нижче кодовий фрагмент показує, як можна використовувати функції для доступу до налаштувань кольорів клієнта.

Керування зустрічами Google Calendar

Aspose.Email надає функції для роботи зі зустрічами в календарях Google. Наступні завдання можна виконати зі зустрічами в календарі Google:

Додати зустрічі.
Отримати список зустрічей.
Отримати конкретну зустріч.
Оновити зустріч.
Перемістити зустріч з одного календаря в інший.
Видалити зустріч.

IGmailClient надає функції, такі як CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment і DeleteAppointment.

Додати зустрічі до Google Calendar

Наведений нижче приклад коду демонструє можливість додавання зустрічі в календар. Щоб досягти цього, виконайте наступні кроки:

Створити та вставити календар.
Отримати список зустрічей з нового календаря.
Створити подію.
Вставити зустріч.

Отримання та оновлення зустрічей Google Calendar

Тут демонструються отримання та оновлення календаря наступним чином:

Отримати конкретну подію.
Змінити подію.
Оновити подію в календарі.

Припускається, що календар з ідентифікатором "calendarId" та унікальним ідентифікатором зустрічі "AppointmentUniqueId" вже отримані. Нижченаведений фрагмент коду показує, як отримати та оновити зустріч.

Переміщення та видалення зустрічей у Google Calendar

Зустріч можна перемістити, вказавши вихідний календар, цільовий календар та унікальний ідентифікатор зустрічі у вихідному календарі. Нижченаведений фрагмент коду показує, як перемістити та видалити зустріч.

FreeBusy запит для Google Calendar

Aspose.Email надає механізм запитування для перевірки, чи настав час зустрічі згідно з критерієм. Для цього надається клас FreebusyQuery, який дозволяє підготувати запит для конкретного календаря.

Цей приклад коду демонструє можливість запитування календаря. У цьому прикладі виконуються наступні завдання:

Створити та вставити календар
Створити зустріч
Вставити зустріч
Підготувати FreeBusyQuery
Отримати відповідь 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: Керування контактами Google у застосунках .NET

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

Aspose.Email підтримує роботу з контактами Gmail. Використовуючи IGmailClient інтерфейс, користувачі можуть отримувати контакти з облікового запису Gmail, створювати нові контакти, а також оновлювати та видаляти існуючі контакти. Gmail дозволяє розробникам виконувати все це за допомогою його публічного API для розробників. Для роботи з контактами Gmail потрібна така інформація користувача: ім’я користувача, електронна адреса, пароль, client ID, client secret, refresh token. У цій статті показано, як:

Доступ до контактів Gmail

Нижче представлено зразковий застосунок, який можна використати для доступу до деталей контактів у всіх групах.

Створити контакти Google

Нижченаведений фрагмент коду показує, як створити контакт у Gmail.

Оновити контакти Google

Після отримання контакту його атрибути можна оновити, і контакт можна зберегти назад у обліковий запис Gmail. Нижченаведений фрагмент коду показує, як отримати контакти з облікового запису Gmail, змінити один з них та зберегти назад.

Видалити контакти Google

Щоб видалити контакт Gmail, клієнт Gmail DeleteContact метод використовується, як показано у наступному прикладі.

Зберегти контакти Google

Aspose.Email дозволяє зберігати контакти у різних форматах, таких як MSG та VCF. Зберегти метод надає можливість це зробити. Нижченаведений фрагмент коду показує, як зберегти контакт.

Net: Надсилання, отримання та керування електронними листами Gmail через SMTP, IMAP та POP3

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

У цьому посібнику показано, як підключитися до сервера Gmail та виконувати типові операції з електронною поштою, такі як надсилання, отримання та управління повідомленнями за допомогою Aspose.Email для .NET. Ви дізнаєтеся, як працювати з протоколами SMTP, IMAP і POP3 через SSL.

Надсилання листів через SMTP-сервер Gmail

Підключення до SMTP-сервера Gmail

Щоб надсилати електронні листи через Gmail, використовуючи протокол SMTP, створіть екземпляр SmtpClient клас і налаштуйте його властивості підключення, включаючи адресу сервера, номер порту, облікові дані та параметри безпеки, як показано у наведеному нижче прикладі коду.

Надіслати електронний лист

Після налаштування підключення ви можете надіслати лист, створивши MailMessage об’єкт і передати його до SmtpClient.Send() метод.

Наведений нижче приклад коду демонструє, як створити електронний лист, задати його властивості, наприклад тему, отримувача та тіло, і надіслати його за допомогою Aspose.Email на C#.

Керування листами за допомогою протоколу IMAP

У цьому розділі показано, як виконувати кілька операцій IMAP, таких як підключення до облікового запису Gmail, доступ до папок, отримання повідомлень та створення папок на сервері.

Підключення до IMAP-сервера

Щоб підключитися до Gmail через IMAP, використовуйте ImapClient клас і вказати сервер, порт та облікові дані. Gmail використовує порт 993 для безпечних IMAP-з’єднань.

Нижче наведений приклад коду демонструє, як створити та налаштувати ImapClient для безпечного підключення до IMAP-сервера Gmail:

Вибір папки та отримання кількості повідомлень

Ви можете отримати доступ до папки Вхідні та отримати загальну кількість повідомлень за допомогою Aspose.Email SelectFolder метод, як показано у наведеному нижче прикладі коду:

Збереження повідомлень локально

Після вибору папки використайте ListMessages() метод для отримання всіх підсумків повідомлень, потім завантаження та зберегти кожне повідомлення як файл EML. Нижче наведений приклад коду демонструє, як виконати це завдання:

Створення нової папки

IMAP дозволяє створювати папки безпосередньо на поштовому сервері. За допомогою Aspose.Email це можна зробити всього одним рядком коду:

Додавання нового повідомлення до папки

Ви можете створити та додати повідомлення до конкретної папки за допомогою MailMessage і ImapClient класи.

Нижчевказаний приклад коду створює MailMessage з відправником, отримувачем, темою та тілом. Потім вибирає папку Вхідні на IMAP‑сервері, підписується на цю папку, якщо підписка ще не здійснена, і врешті‑решт додає створене повідомлення до вибраної папки.

Отримання листів за допомогою протоколу POP3

У цьому розділі показано, як підключитися до облікового запису Gmail через POP3, перевірити інформацію про поштову скриньку та безпечно завантажити повідомлення за допомогою SSL.

Підключення до POP3‑сервера

Створіть та налаштуйте Pop3client екземпляр для підключення до POP3‑серверу Gmail. Використовуйте порт 995 для SSL‑з’єднань. Процес показано у наведеному нижче прикладі коду.

Перевірка стану поштової скриньки

Використайте GetMailboxInfo() метод для перевірки кількості повідомлень та загального розміру поштової скриньки, як показано у наведеному нижче прикладі коду.

Отримання інформації про повідомлення

Щоб отримати інформацію про всі повідомлення в поштовій скриньці, використайте ListMessages() метод. Нижче наведений приклад коду отримує колекцію метаданих повідомлень за допомогою ListMessages(), а потім ітерується по кожному об’єкту інформації про повідомлення, відображаючи ключові деталі, такі як унікальний ідентифікатор повідомлення, індекс послідовності, тема та розмір. Це дозволяє клієнту переглядати підсумки повідомлень без скачування повного вмісту листа.

Отримання та збереження повідомлень

Використайте FetchMessage() метод для отримання повідомлень по одному та збереження їх локально у вигляді файлів .eml.

Net: Підтримка Gmail API у Aspose.Email для .NET

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

Початок роботи з IGmailClient

Aspose.Email для .NET надає потужну підтримку взаємодії з Gmail через IGmailClient інтерфейс. Ви можете керувати повідомленнями та фільтрами у поштовій скринці Gmail — включаючи перелік, отримання, надсилання, додавання та видалення листів, а також керування користувацькими фільтрами для автоматичної класифікації.

Щоб використовувати функції Gmail, потрібно ініціалізувати екземпляр IGmailClient, використовуючи ваш clientId, clientSecret, refreshToken та цільову електронну адресу. У всіх наведених нижче прикладах передбачається така налаштування:

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

Список повідомлень у поштовій скринці Gmail

Отримати всі повідомлення зі скриньки у легковажному форматі GmailMessageInfo об’єктів. Нижченаведений приклад коду демонструє, як отримати список доступних повідомлень у поштовій скринці Gmail без завантаження повного вмісту:

var messages = client.ListMessages();

Отримати та видалити повідомлення Gmail

Нижченаведений приклад коду демонструє, як прочитати та видалити повідомлення з Gmail, використовуючи їх унікальні ідентифікатори:

Використати client.ListMessages() щоб отримати список повідомлень.
Налаштуйте цикл for для перебору перших трьох повідомлень.
У циклі отримуйте кожне повідомлення за допомогою client.FetchMessage(messages[i].Id).
Вивести тему та тіло отриманого повідомлення.
Викличте client.DeleteMessage(messages[i].Id, true) щоб видалити повідомлення та перемістити його у корзину.
Підтвердьте видалення повідомленням.

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.");
}

Надіслати повідомлення через Gmail

Складіть та надішліть електронний лист, включаючи вкладення, за допомогою методу SendMessage(). Нижче представлений приклад коду, який демонструє, як надіслати лист через Gmail з вкладенням:

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