Documentation – برنامه‌نویسی با Gmail

Net: پیکربندی دسترسی API OAuth 2.0 به خدمات گوگل

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

ایجاد پروژه در کنسول توسعه‌دهندگان گوگل برای دسترسی به API

ایجاد یک پروژه در کنسول توسعه‌دهندگان گوگل گامی ضروری برای دسترسی و استفاده از APIهای گوگل در برنامه‌های شما است. این فرایند شامل تنظیم یک پروژه، پذیرش شرایط، تأیید هویت و پیکربندی تنظیمات API برای نیازهای شما می‌شود. مراحل زیر شما را در فرآیند ایجاد پروژه و دریافت اعتبارهای لازم برای سرویس‌هایی مانند Calendar و Contacts API راهنمایی می‌کند.

مراحل ایجاد پروژه در کنسول توسعه‌دهندگان گوگل

به لینک https://cloud.google.com/console/project بروید و با اطلاعات حساب جیمیل خود وارد شوید

کادر "I have read and agree to all Terms of Service for the Google Cloud Platform products." را تیک بزنید و دکمه Create را فشار دهید

"SMS Verification" درخواست خواهد شد. دکمه ادامه (continue) را فشار دهید:

کشور خود را وارد کنید و شماره موبایل را وارد کنید. دکمه: Send Verification Code را فشار دهید.

کد تأیید دریافت‌شده روی موبایل خود را وارد کنید.

در لیست APIs & auth \ APIs وضعیت APIهای Calendar و 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 - فرآیند احراز هویت کاربر گوگل و دریافت توکن‌های لازم برای تعامل با APIهای گوگل مانند Calendar، Contacts و Gmail را ساده می‌کند.
کلاس GoogleUser - برای بسته‌بندی و مدیریت اعتبارهای مورد نیاز برای احراز هویت کاربر و تعامل با خدمات گوگل، به‌ویژه APIهایی که به احراز هویت OAuth 2.0 نیاز دارند مانند تقویم گوگل، طراحی شده است.
کلاس TokenResponse - مدلی است که برای نمایش و مدیریت داده‌های پاسخ از نقطه انتهای توکن OAuth 2.0 طراحی شده است، جایی که توکن‌های دسترسی در ازای مجوز دریافت می‌شوند.

در مقالات زیر نمونه‌های کد می‌توانید پیدا کنید که نحوه استفاده از این کلاس‌ها را در محیط .NET برای برقراری تعامل امن با خدمات OAuth 2.0 نشان می‌دهند.

احراز هویت OAuth 2.0 با کلاس GoogleOAuthHelper

این کلاس ایجاد URL کد مجوز، تولید چالش‌های کد و بازیابی توکن‌های دسترسی و توکن‌های تازه‌سازی را مدیریت می‌کند. با استفاده از GoogleOAuthHelper، توسعه‌دهندگان می‌توانند جریان OAuth 2.0 را ساده‌سازند و ارتباط امن و کارآمدی با خدمات گوگل برقرار کنند. قطعه کد زیر نشان می‌دهد چگونه پیاده‌سازی کنید 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 کد مجوز تولید شود.
آدرس را در مرورگر باز کنید و تمام عملیات را تکمیل کنید. در نتیجه، یک کد مجوز دریافت خواهید کرد.
از کد مجوز برای دریافت توکن تازه‌سازی استفاده کنید.
هنگامی که توکن تازه‌سازی موجود باشد، می‌توانید از آن برای دریافت توکن‌های دسترسی استفاده کنید.

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 در برنامه‌های .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(). این شیء اطلاعات رنگ فهرست رنگ‌های پیش‌زمینه، رنگ‌های پس‌زمینه و تاریخ و زمان به‌روزرسانی را باز می‌گرداند.

دستیابی به تنظیمات مشتری

قطعه کد زیر نشان می‌دهد چگونه می‌توان از توابع برای دسترسی به تنظیمات مشتری استفاده کرد:

دسترسی به اطلاعات رنگ

قطعه کد زیر نشان می‌دهد چگونه می‌توان از توابع برای دسترسی به تنظیمات رنگ مشتری استفاده کرد.

مدیریت قرار ملاقات‌های تقویم گوگل

Aspose.Email ویژگی‌هایی برای کار با قرار ملاقات‌ها در تقویم‌های گوگل فراهم می‌کند. وظایف زیر می‌توانند بر روی قرار ملاقات‌ها در تقویم گوگل انجام شوند:

افزودن قرار ملاقات‌ها.
دریافت فهرست قرار ملاقات‌ها.
دریافت قرار ملاقات خاص.
به‌روزرسانی یک تقویم.
انتقال قرار ملاقات از یک تقویم به تقویم دیگر.
حذف قرار ملاقات.

IGmailClient توابعی مانند CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment و DeleteAppointment.

افزودن قرارهای ملاقات به تقویم Google

نمونه کد زیر ویژگی افزودن یک قرار ملاقات به تقویم را نشان می‌دهد. برای انجام این کار، مراحل زیر را دنبال کنید:

یک تقویم ایجاد و وارد کنید.
بازیابی فهرست قرارهای ملاقات از یک تقویم جدید.
یک قرار ملاقات ایجاد کنید.
درج یک قرار ملاقات.

دریافت و به‌روزرسانی قرار ملاقات‌های تقویم گوگل

در اینجا بازیابی و به‌روزرسانی تقویم به‌صورت زیر نشان داده شده است:

یک قرار ملاقات خاص را بازیابی کنید.
قرار ملاقات را ویرایش کنید.
قرار ملاقات را در تقویم به‌روز کنید.

فرض می‌شود که یک تقویم با شناسه "calendarId" و شناسه یکتا "AppointmentUniqueId" قبلاً استخراج شده‌اند. قطعه کد زیر نشان می‌دهد چگونه یک قرار ملاقات را بازیابی و به‌روزرسانی کنید.

انتقال و حذف قرار ملاقات‌ها در تقویم گوگل

قرار ملاقات می‌تواند با ارائه تقویم منبع، تقویم مقصد و شناسه یکتا در تقویم منبع جابه‌جا شود. قطعه کد زیر نشان می‌دهد چگونه یک قرار ملاقات را جابه‌جا و حذف کنید.

پرس‌وجوی FreeBusy برای تقویم گوگل

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: مدیریت تماس‌های گوگل در برنامه‌های .NET

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

Aspose.Email از کار با مخاطبان Gmail پشتیبانی می‌کند. با استفاده از IGmailClient در این رابط، کاربران می‌توانند تماس‌ها را از یک حساب Gmail بازیابی، تماس جدید ایجاد، و تماس‌های موجود را به‌روزرسانی یا حذف کنند. Gmail به توسعه‌دهندگان اجازه می‌دهد تمام این کارها را با استفاده از API عمومی خود انجام دهند. اطلاعات کاربری زیر برای کار با تماس‌های Gmail مورد نیاز است: نام کاربری، آدرس ایمیل، رمز عبور، شناسه مشتری (client ID)، راز مشتری (client secret) و توکن تازه‌سازی. این مقاله نشان می‌دهد چگونه:

دسترسی به مخاطبان Gmail

در ادامه یک برنامه نمونه آورده شده است که می‌تواند برای دسترسی به جزئیات تماس‌ها در تمام گروه‌ها استفاده شود.

ایجاد تماس‌های گوگل

قطعه کد زیر نشان می‌دهد چگونه یک تماس در Gmail ایجاد کنید.

به‌روزرسانی تماس‌های گوگل

پس از بازیابی یک تماس، می‌توانید ویژگی‌های آن را به‌روزرسانی کنید و تماس را دوباره در حساب Gmail ذخیره کنید. قطعه کد زیر نشان می‌دهد چگونه تماس‌ها را از حساب Gmail بازیابی کرده و یکی از آنها را تغییر داده و سپس ذخیره کنید.

حذف تماس‌های گوگل

برای حذف یک تماس Gmail، کلاینت Gmail DeleteContact متد همان‌طور که در قطعه نمونه زیر نشان داده شده است استفاده می‌شود.

ذخیره تماس‌های گوگل

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 برای اتصالات امن IMAP از پورت ۹۹۳ استفاده می‌کند.

نمونه کد زیر نشان می‌دهد چگونه یک ImapClient برای اتصال امن به سرور IMAP Gmail:

انتخاب یک پوشه و دریافت تعداد پیام‌ها

می‌توانید به پوشه Inbox دسترسی پیدا کنید و تعداد کل پیام‌ها را با استفاده از Aspose.Email بازیابی کنید SelectFolder متد همان‌طور که در نمونه کد زیر نشان داده شده است:

ذخیره پیام‌ها به‌صورت محلی

پس از انتخاب یک پوشه، از ListMessages() متد برای دریافت خلاصه تمام پیام‌ها، سپس دانلود و ذخیره هر پیام به صورت یک فایل EML. نمونه کد زیر نشان می‌دهد چگونه این کار را انجام دهید:

ایجاد یک پوشه جدید

IMAP به شما اجازه می‌دهد پوشه‌ها را به‌صورت مستقیم بر روی سرور ایمیل ایجاد کنید. با Aspose.Email، می‌توانید این کار را تنها با یک خط کد انجام دهید:

افزودن پیام جدید به یک پوشه

می‌توانید با استفاده از MailMessage و ImapClient کلاس‌ها را می‌سازد.

نمونه کد زیر یک MailMessage با فرستنده، گیرنده، موضوع و متن. سپس پوشه Inbox را در سرور IMAP انتخاب می‌کند، اگر قبلاً مشترک نشده باشد به آن مشترک می‌شود و در نهایت پیام ایجاد شده را به پوشه انتخاب شده اضافه می‌کند.

دریافت ایمیل‌ها با استفاده از پروتکل POP3

این بخش نشان می‌دهد چگونه با استفاده از POP3 به حساب Gmail متصل شوید، اطلاعات صندوق‌پستی را بررسی کنید و پیام‌ها را به‌صورت امن با SSL دانلود کنید.

اتصال به سرور POP3

یک Pop3client نمونه برای اتصال به سرور POP3 Gmail. برای اتصالات SSL از پورت ۹۹۵ استفاده کنید. فرآیند در نمونه کد زیر نشان داده شده است.

بررسی وضعیت صندوق‌پستی

از GetMailboxInfo() متد برای بررسی تعداد پیام‌ها و اندازه کل صندوق‌پستی همان‌طور که در نمونه کد زیر نشان داده شده است.

دریافت اطلاعات پیام

برای دریافت اطلاعات درباره تمام پیام‌های موجود در صندوق‌پستی، از ListMessages() متد. نمونه کد زیر یک مجموعه از فراداده‌های پیام را با استفاده از ListMessages()، سپس برای هر شیء اطلاعات پیام پیمایش می‌کند تا جزئیات کلیدی مانند شناسه منحصر به‌فرد پیام، شاخص ترتیب، موضوع و اندازه را نمایش دهد. این امکان را برای یک کلاینت فراهم می‌کند تا خلاصه پیام‌ها را بدون دانلود محتوای کامل ایمیل پیش‌نمایش کند.

دریافت و ذخیره پیام‌ها

از FetchMessage() متد برای دریافت پیام‌ها به‌صورت تک‌تک و ذخیره آنها به‌صورت محلی به‌صورت فایل‌های .eml.

Net: پشتیبانی API Gmail با 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}");