Documentation – Програмиране с Gmail

Net: Конфигуриране на достъпа до API на Google Services чрез OAuth 2.0

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 потребител и получаване на необходимите токени за взаимодействие с Google API, като Calendar, Contacts и Gmail.
GoogleUser class - Предназначен е да обхваща и управлява идентификационните данни, необходими за потребител, за да се удостовери и взаимодейства с Google services, конкретно 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 services. Следният кодов откъс показва как да се имплементира 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 адреса в браузър и завършете всички операции. В резултат ще получите код за упълномощаване.
Използвайте кода за упълномощаване, за да получите refresh токен.
Когато съществува refresh токен, можете да го използвате за извличане на токени за достъп.

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(). Той връща списъка с настройки, както е дадено по-долу:

ред на полетата за дата
показване на всички часови зони
hideInvitations
форматиране на 24-часово време
defaultCalendarMode
стандартна продължителност на събитие
локализация
remindOnRespondedEventsOnly
alternateCalendar
местоположение на потребителя
hideWeekends
showDeclinedEvents
начало на седмицата
време
customCalendarMode
етикет за часова зона
часова зона
useKeyboardShortcuts
страна

Подобно, информация за цвят за клиентите може да се извлече чрез 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 контакти са необходими следните потребителски данни: потребителско име, имейл адрес, парола, клиент ID, клиент secret, токен за обновяване. Тази статия показва как да:

Достъп до контакти в 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.

Изпращане на имейли чрез Gmail SMTP сървър

Свързване към Gmail SMTP сървъра

За да изпращате имейли чрез Gmail, използвайки SMTP протокола, създайте екземпляр на SmtpClient клас и конфигурирайте свойствата му за свързване, включително адрес на сървъра, номер на порт, идентификационни данни и опции за сигурност, както е показано в примерния код по-долу.

Изпращане на имейл съобщение

След като връзката е конфигурирана, можете да изпратите имейл, като създадете MailMessage обект и предаването му към SmtpClient.Send() метод.

Следният примерен код демонстрира как да създадете имейл съобщение, зададете неговите свойства, например тема, получател и тяло, и да го изпратите с Aspose.Email в C#.

Управление на имейли с IMAP протокола

Този раздел показва как да извършвате няколко IMAP операции като свързване към Gmail акаунт, достъп до папки, извличане на съобщения и създаване на папки на сървъра.

Свързване към IMAP сървъра

За да се свържете с Gmail чрез IMAP, използвайте ImapClient клас и зададете сървъра, порта и идентификационните данни. Gmail използва порт 993 за сигурни IMAP връзки.

Следният примерен код демонстрира как да създадете и конфигурирате ImapClient за сигурно свързване към Gmail IMAP сървър:

Избиране на папка и получаване на брой съобщения

Можете да получите достъп до папка Inbox и да извлечете общия брой съобщения с помощта на Aspose.Email SelectFolder метод, както е показано в примерния код по-долу:

Записване на съобщения локално

След избиране на папка, използвайте ListMessages() метод за получаване на обобщения на всички съобщения, след което да ги изтеглите и запис всяко съобщение като EML файл. Следният примерен код демонстрира как да изпълните тази задача:

Създаване на нова папка

IMAP ви позволява да създавате папки директно на имейл сървъра. С Aspose.Email можете да го направите с една ред код:

Добавяне на ново съобщение към папка

Можете да създадете и добавите съобщение към конкретна папка, използвайки MailMessage и ImapClient класове.

Кодът по-долу конструира MailMessage с изпращач, получател, тема и тяло. След това избира папка Inbox на IMAP сървъра, абонира се за тази папка, ако все още не е абониран, и накрая добавя създеното съобщение към избраната папка.

Получаване на имейли с POP3 протокола

Този раздел показва как да се свържете към Gmail акаунт чрез POP3, да проверите информация за пощенската кутия и да изтеглите съобщения безопасно, използвайки SSL.

Свързване към POP3 сървъра

Създайте и конфигурирайте Pop3client екземпляр за свързване към Gmail POP3 сървър. Използвайте порт 995 за SSL връзки. Процесът е показан в примерния код по-долу.

Проверка състояние на пощенската кутия

Използвайте GetMailboxInfo() метод за проверка на броя съобщения и общия размер на пощенската кутия, както е показано в примерния код по-долу.

Получаване на информация за съобщения

За да получите информация за всички съобщения в пощенската кутия, използвайте ListMessages() метод. Следният примерен код получава колекция от метаданни за съобщения, използвайки ListMessages(), след което итерира през всеки обект с информация за съобщение, за да покаже ключови детайли като уникален ID на съобщението, индекс в последователността, тема и размер. Това позволява на клиента да преглежда обобщенията на съобщенията без да изтегля пълното съдържание на имейла.

Изтегляне и запазване на съобщения

Използвайте 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}");