Documentation – การเขียนโปรแกรมด้วย Gmail

Net: กำหนดค่า OAuth 2.0 API Access สำหรับบริการของ Google

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

สร้างโครงการใน Google Developer Console สำหรับการเข้าถึง API

การสร้างโครงการใน Google Developer Console เป็นขั้นตอนสำคัญสำหรับการเข้าถึงและใช้ Google APIs ในแอปพลิเคชันของคุณ กระบวนการนี้รวมถึงการตั้งค่าโครงการ การยอมรับเงื่อนไข การยืนยันตัวตนของคุณและการกำหนดค่า API ให้ตรงกับความต้องการของคุณ ขั้นตอนต่อไปนี้จะแนะนำคุณผ่านกระบวนการสร้างโครงการและรับข้อมูลรับรองที่จำเป็นสำหรับบริการเช่น Calendar และ Contacts APIs

ขั้นตอนการสร้างโครงการใน 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" จะถูกขอ ให้กดปุ่มดำเนินการต่อ:

ใส่ชื่อประเทศของคุณและใส่หมายเลขมือถือ กดปุ่ม: ส่งรหัสยืนยัน

ใส่รหัสยืนยันที่ได้รับบนมือถือของคุณ

ในรายการ APIs & auth \ APIs ให้เปิดสถานะของ Calendar API และ Contacts API ปิดทั้งหมดอื่น ๆ

ในเมนู APIs & auth -> Credentials ให้กดปุ่ม "CREATE 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 ง่ายขึ้นและรับ token ที่จำเป็นเพื่อโต้ตอบกับ Google APIs เช่น Calendar, Contacts, และ Gmail
GoogleUser class - ถูกออกแบบให้รวมและจัดการข้อมูลรับรองที่ผู้ใช้ต้องการเพื่อรับรองและโต้ตอบกับบริการของ Google โดยเฉพาะ API ที่ต้องการการรับรอง OAuth 2.0 เช่น Google Calendar
TokenResponse class - เป็นโมเดลที่ออกแบบให้แทนและจัดการข้อมูลการตอบกลับจาก OAuth 2.0 token endpoint ซึ่ง access token จะได้รับจากการแลกเปลี่ยนการอนุญาต

ในบทความต่อไปนี้คุณจะพบตัวอย่างโค้ดที่แสดงวิธีใช้คลาสเหล่านี้ในสภาพแวดล้อม .NET เพื่อสร้างการโต้ตอบที่ปลอดภัยกับบริการ OAuth 2.0

การรับรอง OAuth 2.0 ด้วยคลาส GoogleOAuthHelper

คลาสนี้จัดการการสร้าง URL ของโค้ดอนุมัติ การสร้าง code challenges และการรับ access และ refresh token โดยการใช้ 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 Calendar

Aspose.Email ให้แอปพลิเคชันจัดการปฏิทิน Gmail โดยใช้ IGmailClient ซึ่งให้คุณลักษณะเช่น การเพิ่ม, การลบ และการอัปเดต Gmail calendar คลาสไคลเอนต์นี้ส่งคืนรายการของอ็อบเจ็กต์ประเภท ExtendedCalendar ที่มีข้อมูลเกี่ยวกับรายการปฏิทิน Gmail. IGmailClient คลาสเปิดเผยฟังก์ชันต่อไปนี้สำหรับปฏิทิน:

CreateCalendar สามารถใช้เพื่อแทรกปฏิทินใหม่
ListCalendars สามารถใช้เพื่อรับรายการปฏิทินทั้งหมดของลูกค้า
DeleteCalendar สามารถใช้เพื่อทำการลบปฏิทิน
FetchCalendar สามารถใช้เพื่อดึงปฏิทินเฉพาะของไคลเอนต์
UpdateCalendar ฟังก์ชันนี้ใช้เพื่อใส่กลับปฏิทินที่แก้ไขของลูกค้า

เพื่อเข้าถึงปฏิทิน GoogleTestUser จะถูกเริ่มต้นด้วยข้อมูลรับรองบัญชี Gmail GoogleOAuthHelper จะใช้เพื่อรับโทเค็นการเข้าถึงสำหรับผู้ใช้ ซึ่งต่อมาจะใช้เพื่อเริ่มต้น IGmailClient.

แทรก, ดึงและอัปเดต Gmail Calendar

สำหรับการแทรกปฏิทิน ให้เริ่มต้นอ็อบเจ็กต์ประเภท Calendar และแทรกโดยใช้ CreateCalendar() ฟังก์ชัน. CreateCalendar() ส่งคืน id ของปฏิทินที่เพิ่งแทรกใหม่ ID นี้สามารถใช้เพื่อดึงปฏิทินจากเซิร์ฟเวอร์ได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการแทรก ดึง และอัปเดตปฏิทิน

ลบ Google Calendar เฉพาะเจาะจง

เพื่อทำการลบปฏิทินเฉพาะ เราต้องดึงรายการปฏิทินทั้งหมดของไคลเอนต์แล้วลบตามที่ต้องการ 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

ที่นี่จะแสดงการดึงและอัปเดตปฏิทินตามที่ต่อไปนี้:

ดึงนัดหมายบางส่วน.
แก้ไขนัดหมาย.
อัปเดตนัดหมายในปฏิทิน.

สมมติว่าปฏิทินที่มี id "calendarId" และนัดหมายที่มีรหัสเฉพาะ "AppointmentUniqueId" ได้รับการสกัดแล้ว ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีดึงและอัปเดตนัดหมาย.

ย้ายและลบนัดหมายใน Google Calendar

สามารถย้ายนัดหมายได้โดยระบุปฏิทินต้นทาง ปฏิทินปลายทาง และรหัสเฉพาะของนัดหมายในปฏิทินต้นทาง ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีย้ายและลบนัดหมาย.

FreeBusy Query สำหรับ 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 Contacts ในแอปพลิเคชัน .NET

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

Aspose.Email รองรับการทำงานกับผู้ติดต่อ Gmail โดยใช้ IGmailClient อินเทอร์เฟซ ผู้ใช้สามารถดึงผู้ติดต่อจากบัญชี Gmail สร้างผู้ติดต่อใหม่ และอัปเดตรวมถึงลบผู้ติดต่อที่มีอยู่ Gmail อนุญาตให้ผู้พัฒนาทำทั้งหมดนี้โดยใช้ Public Developer API ของมัน ข้อมูลผู้ใช้ต่อไปนี้จำเป็นสำหรับการทำงานกับผู้ติดต่อ Gmail: ชื่อผู้ใช้ ที่อยู่อีเมล รหัสผ่าน client ID client secret refresh token บทความนี้แสดงวิธี:

การเข้าถึงผู้ติดต่อ Gmail

ต่อไปนี้เป็นแอปพลิเคชันตัวอย่างที่สามารถใช้เข้าถึงรายละเอียดของผู้ติดต่อในทุกกลุ่ม.

สร้าง Google Contacts

ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีสร้างผู้ติดต่อใน Gmail.

อัปเดต Google Contacts

เมื่อดึงผู้ติดต่อมาแล้ว สามารถอัปเดตแอตทริบิวต์และบันทึกผู้ติดต่อกลับไปยังบัญชี Gmail ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีดึงผู้ติดต่อจากบัญชี Gmail แล้วแก้ไขหนึ่งรายการและบันทึกกลับ.

ลบ Google Contacts

เพื่อทำการลบผู้ติดต่อ Gmail คลไอเอนท์ Gmail DeleteContact เมธอดนี้ใช้ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้.

บันทึก Google Contacts

Aspose.Email อนุญาตให้บันทึกผู้ติดต่อเป็นรูปแบบเอาต์พุตต่าง ๆ เช่น MSG และ VCF. บันทึก เมธอดนี้ให้ความสามารถในการทำเช่นนี้ ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีบันทึกผู้ติดต่อ.

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

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()และจากนั้นวนซ้ำผ่านอ็อบเจกท์ข้อมูลแต่ละข้อความเพื่อแสดงรายละเอียดสำคัญ เช่น รหัสข้อความที่เป็นเอกลักษณ์, ดัชนีลำดับ, หัวเรื่อง, และขนาด ซึ่งทำให้ไคลเอนต์สามารถดูสรุปข้อความโดยไม่ต้องดาวน์โหลดเนื้อหาอีเมลเต็ม.

ดึงและบันทึกข้อความ

ใช้ FetchMessage() เมธอดเพื่อดึงข้อความทีละหนึ่งและบันทึกลงในเครื่องเป็นไฟล์ .eml.