Documentation – תכנות עם Gmail

Net: הגדרת גישה ל-API של OAuth 2.0 לשירותי Google

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

צור פרויקט ב‑Google Developer Console עבור גישה ל‑API

יצירת פרויקט ב‑Google Developer Console הוא צעד חיוני לגישה ושימוש ב‑API של Google עבור היישומים שלך. תהליך זה כולל הקמת פרויקט, הסכמה לתנאים, אימות זהות, והגדרת הגדרות 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 הפוך את ה‑status של Calendar API ו‑Contacts API ל‑ON. כבה את כל השאר (OFF).

ב‑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 - מפשטת את תהליך האימות של משתמש Google וקבלת האסימונים הדרושים לתקשרות עם API של Google, כגון Calendar, Contacts ו-Gmail.
מחלקת GoogleUser - היא נועדה לעטוף ולנהל את האישורים הדרושים למשתמש לאימות ולהתקשרות עם שירותי Google, במיוחד API שדורשים אימות OAuth 2.0 כגון Google Calendar.
מחלקת TokenResponse - זהו מודל שנועד לייצג ולטפל בנתוני תגובה מנקודת הקצה של אסימוני 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(). היא מחזירה את רשימת ההגדרות כפי שמופיעה למטה:

סדר השדה תאריך
הצג את כל אזורי הזמן
הסתר הזמנות
פורמט זמן 24 שעות
מצב לוח שנה ברירת מחדל
אורך אירוע ברירת מחדל
שפה
remindOnRespondedEventsOnly
לוח שנה חלופי
מיקום משתמש
הסתר סופי שבוע
showDeclinedEvents
התחלת שבוע
מזג אוויר
customCalendarMode
timezoneLabel
אזור זמן
useKeyboardShortcuts
מדינה

באופן דומה ניתן לקבל מידע צבע עבור לקוחות באמצעות IGmailClient.GetColors(). אובייקט מידע הצבע הזה מחזיר את רשימת צבעי חזית, צבעי רקע ותאריך ושעת העדכון.

גישה להגדרות לקוח

קטע הקוד למטה מראה כיצד ניתן להשתמש בפונקציות לגישה להגדרות הלקוח:

גישה למידע על צבעים

קטע הקוד למטה מראה כיצד ניתן להשתמש בפונקציות לגישה להגדרות הצבע של הלקוח.

נהל פגישות בלוח השנה של Google

Aspose.Email מספקת תכונות לעבודה עם פגישות בלוח השנה של Google. המשימות הבאות ניתנות לביצוע עם פגישות בלוח השנה של Google:

הוספת פגישות.
קבל רשימת פגישות.
קבל פגישה ספציפית.
עדכון פגישה.
העברת פגישה מלוח שנה אחד לאחר.
מחיקת פגישה.

IGmailClient מספקת פונקציות כגון CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment ו DeleteAppointment.

הוספת פגישות ל-Google Calendar

דוגמת הקוד למטה מציגה את הפונקציה של הוספת פגישה בלוח שנה. כדי לבצע זאת, פעל לפי הצעדים:

צור והוסף לוח שנה.
קבלת רשימת הפגישות מלוח שנה חדש.
צור פגישה.
הוספת פגישה.

קבל ועדכן פגישות בלוח השנה של Google

כאן מודגמים האחזור והעדכון של לוח השנה כדלקמן:

קבל פגישה ספציפית.
שנה את הפגישה.
עדכן את הפגישה בלוח השנה.

נניח כי לוח שנה עם מזהה "calendarId" ומזהה ייחודי של פגישה "AppointmentUniqueId" כבר נלקחו. הקטע הקוד הבא מראה כיצד לקבל ולעדכן פגישה.

העבר ומחק פגישות בלוח השנה של Google

ניתן להעביר פגישה על ידי מתן לוח השנה המקור, לוח השנה יעד והמזהה הייחודי של הפגישה בלוח המקור. הקטע הקוד הבא מראה כיצד להעביר ולמחוק פגישה.

שאילתת FreeBusy בלוח השנה של Google

Aspose.Email מספקת מנגנון שאילתות לבדיקת האם פגישה נדרשת לפי קריטריונים. מחלקת FreebusyQuery מסופקת למטרה זו ומאפשרת להכין שאילתה עבור לוח שנה ספציפי.

דוגמת קוד זו מציגה את המאפיין של שאילת לוח שנה. המשימות הבאות מתבצעות בדוגמה:

צור והוסף לוח שנה
צור פגישה
הוסף פגישה
הכן שאילתת FreeBusy
קבל את 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.

שליחת הודעות דרך שרת 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:

בחירת תיקייה וקבלת מספר ההודעות

ניתן לגשת לתיקיית הדואר הנכנס ולאחזר את סך כל ההודעות באמצעות Aspose.Email SelectFolder שיטה כפי שמוצג בדוגמת הקוד למטה:

שמירת הודעות מקומית

לאחר בחירת תיקייה, השתמש ב- ListMessages() שיטה לקבלת כל סיכומי ההודעות, ולאחר מכן הורדה ו- שמירה כל הודעה כקובץ EML. דוגמת הקוד למטה מציגה כיצד לבצע משימה זו:

יצירת תיקייה חדשה

IMAP מאפשר ליצור תיקיות ישירות על שרת האימייל. עם Aspose.Email ניתן לבצע זאת בשורת קוד אחת בלבד:

הוספת הודעה חדשה לתיקייה

ניתן ליצור ולהוסיף הודעה לתיקייה ספציפית באמצעות ה- MailMessage ו ImapClient מחלקות.

דוגמת הקוד למטה בונה MailMessage עם השולח, הנמען, הנושא והגוף. לאחר מכן, הוא בוחר את תיקיית הדואר הנכנס בשרת IMAP, נרשם לאותה תיקייה אם עוד לא נרשם, ולבסוף מצרף את ההודעה שנוצרה לתיקייה שנבחרה.

אחזור הודעות באמצעות פרוטוקול POP3

סעיף זה מציג כיצד להתחבר לחשבון Gmail דרך POP3, לבדוק מידע על תיבת הדואר, ולהוריד הודעות באופן מאובטח באמצעות SSL.

התחברות לשרת POP3

צור והגדר Pop3client מופע כדי להתחבר לשרת Gmail POP3. השתמש בפורט 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}");