Documentation – Gmail 프로그래밍

Net: Google 서비스에 대한 OAuth 2.0 API 액세스 구성

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

API 액세스를 위한 Google 개발자 콘솔 프로젝트 생성

Google 개발자 콘솔에서 프로젝트를 생성하는 것은 애플리케이션이 Google API에 접근하고 활용하기 위한 필수 단계입니다. 이 과정에는 프로젝트 설정, 약관 동의, 신원 확인 및 API 설정 구성이 포함됩니다. 다음 단계에서는 프로젝트를 생성하고 Calendar 및 Contacts API와 같은 서비스에 필요한 자격 증명을 얻는 방법을 안내합니다.

Google 개발자 콘솔에서 프로젝트 생성 단계

링크 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의 상태를 켭니다. 다른 모든 API는 끕니다.

"APIs & auth -> Credentials"에서 "OAuth" 섹션 아래의 "CREAET NEW CLIENT ID" 버튼을 누릅니다. 제공된 옵션 중 "Installed application"과 "Other"를 선택하고 "Create Client ID" 버튼을 클릭합니다. 이 섹션의 샘플 코드에서 사용할 클라이언트 ID와 클라이언트 비밀을 기록해 두세요.

보안 Google OAuth 2.0 통합

Aspose.Email for .NET에서 Google OAuth 2.0을 사용할 때는 다음 클래스가 필요합니다:

GoogleOAuthHelper 클래스 - Google 사용자를 인증하고 Calendar, Contacts, Gmail과 같은 Google API와 상호 작용하는 데 필요한 토큰을 얻는 과정을 단순화합니다.
GoogleUser 클래스 - 사용자가 Google 서비스에 인증하고 상호 작용하는 데 필요한 자격 증명을 캡슐화하고 관리하도록 설계되었습니다. 특히 Google Calendar와 같이 OAuth 2.0 인증이 필요한 API에 사용됩니다.
TokenResponse 클래스 - OAuth 2.0 토큰 엔드포인트에서 응답 데이터를 나타내고 처리하도록 설계된 모델이며, 여기서 액세스 토큰은 인가와 교환하여 얻습니다.

다음 문서에서는 .NET 환경에서 이러한 클래스를 사용하여 OAuth 2.0 서비스와 안전하게 상호 작용하는 방법을 보여주는 코드 샘플을 찾을 수 있습니다.

GoogleOAuthHelper 클래스를 이용한 OAuth 2.0 인증

이 클래스는 인가 코드 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();

OAuth 2.0 인증을 위한 GoogleUser 클래스

다음 코드 조각은 어떻게 구현하는지 보여줍니다 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;
}

TokenResponse 클래스를 사용한 OAuth 2.0 인증

다음 코드 조각은 어떻게 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: .NET 애플리케이션에서 Google 캘린더 관리

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

Gmail 캘린더 추가, 편집 및 삭제

Aspose.Email는 애플리케이션이 Gmail 캘린더를 관리하도록 허용합니다 IGmailClient 이 클래스는 Gmail 캘린더 추가, 삭제 및 업데이트와 같은 기능을 제공하며, Gmail 캘린더 항목에 대한 정보를 포함하는 ExtendedCalendar 타입 객체 목록을 반환합니다. IGmailClient 클래스는 캘린더를 위한 다음 기능들을 제공합니다:

CreateCalendar 새 캘린더를 삽입하는 데 사용할 수 있습니다.
ListCalendars 클라이언트의 모든 캘린더 목록을 가져오는 데 사용할 수 있습니다.
DeleteCalendar 캘린더를 삭제하는 데 사용할 수 있습니다.
FetchCalendar 클라이언트의 특정 캘린더를 가져오는 데 사용할 수 있습니다.
UpdateCalendar 이 함수는 클라이언트의 수정된 캘린더를 다시 삽입할 때 사용됩니다.

캘린더에 접근하기 위해 GoogleTestUser를 Gmail 계정 자격 증명으로 초기화합니다. GoogleOAuthHelper를 사용하여 사용자의 액세스 토큰을 얻고, 이를 사용해 IGmailClient를 초기화합니다.

Gmail 캘린더 삽입, 조회 및 업데이트

캘린더를 삽입하려면 Calendar 타입 객체를 초기화하고 다음을 사용하여 삽입합니다. CreateCalendar() 함수. CreateCalendar() 새로 삽입된 캘린더의 ID를 반환합니다. 이 ID는 서버에서 캘린더를 가져오는 데 사용할 수 있습니다. 다음 코드 스니펫은 캘린더를 삽입, 가져오기 및 업데이트하는 방법을 보여줍니다.

특정 Google 캘린더 삭제

특정 캘린더를 삭제하려면 클라이언트의 모든 캘린더 목록을 가져온 후 필요한 대로 삭제해야 합니다. ListCalendars() 목록을 반환합니다 ExtendedCalendar Gmail 캘린더를 포함합니다. 다음 코드 스니펫은 특정 캘린더를 삭제하는 방법을 보여줍니다.

캘린더 접근 제어

Aspose.Email은 캘린더 항목에 대한 접근을 완전하게 제어합니다. ListAccessRules() 함수는 아래에 의해 제공됩니다 IGmailClient 목록을 반환합니다. AccessControlRule. 개별 규칙 정보를 검색, 수정 및 클라이언트 캘린더에 다시 저장할 수 있습니다. IGmailClient 액세스 제어 규칙을 관리하기 위한 다음 기능들을 포함합니다.

ListAccessRules 이 함수는 AccessControlRule 목록을 제공합니다.
CreateAccessRule 이 함수는 캘린더에 대한 새 접근 규칙을 생성합니다.
UpdateAccessRule 이 함수는 접근 규칙을 업데이트하는 데 사용됩니다.
FetchAccessRule 클라이언트 캘린더에 대한 특정 접근 규칙을 가져오는 데 사용할 수 있습니다.
DeleteAccessRule 이 함수는 접근 규칙을 삭제하는 데 사용됩니다.

다음 코드 스니펫은 접근 규칙을 관리하는 함수를 사용하는 방법을 보여줍니다:

캘린더 클라이언트 설정 및 색상 정보

Aspose.Email는 다음을 사용하여 클라이언트 설정에 접근하는 것을 지원합니다 IGmailClient.GetSettings(). 아래와 같이 설정 목록을 반환합니다:

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

클라이언트의 색상 정보도 다음을 사용하여 검색할 수 있습니다 IGmailClient.GetColors(). 이 색상 정보 객체는 전경 색상, 배경 색상 및 업데이트 일시 목록을 반환합니다.

클라이언트 설정 접근

다음 코드 스니펫은 클라이언트 설정에 접근하기 위해 함수를 사용하는 방법을 보여줍니다:

색상 정보 접근

다음 코드 스니펫은 클라이언트 색상 설정에 접근하기 위해 함수를 사용하는 방법을 보여줍니다.

Google 캘린더 약속 관리

Aspose.Email은 Google 캘린더에서 약속을 작업하기 위한 기능을 제공합니다. 다음 작업을 Google 캘린더의 약속에 대해 수행할 수 있습니다:

약속을 추가합니다.
약속 목록을 검색합니다.
특정 약속을 검색합니다.
약속을 업데이트합니다.
약속을 한 캘린더에서 다른 캘린더로 이동합니다.
약속을 삭제합니다.

IGmailClient 다음과 같은 기능을 제공합니다: CreateAppointment, FetchAppointment, UpdateAppointment, ListAppointments, MoveAppointment 및 DeleteAppointment.

Google 캘린더에 약속 추가

다음 코드 샘플은 캘린더에 약속을 추가하는 기능을 보여줍니다. 이를 위해 다음 단계에 따라 수행하십시오:

캘린더를 만들고 삽입합니다.
새 캘린더에서 약속 목록을 가져옵니다.
약속 만들기.
약속을 삽입합니다.

Google 캘린더 약속 검색 및 업데이트

여기에 캘린더의 검색 및 업데이트가 다음과 같이 보여집니다:

특정 약속을 검색합니다.
약속을 수정합니다.
캘린더에서 약속을 업데이트합니다.

캘린더 ID가 "calendarId"이고 약속 고유 ID가 "AppointmentUniqueId"인 캘린더가 이미 추출된 것으로 가정합니다. 다음 코드 조각은 약속을 검색하고 업데이트하는 방법을 보여줍니다.

Google 캘린더에서 약속 이동 및 삭제

약속은 소스 캘린더, 대상 캘린더 및 소스 캘린더의 약속 고유 ID를 제공함으로써 이동할 수 있습니다. 다음 코드 조각은 약속을 이동하고 삭제하는 방법을 보여줍니다.

Google 캘린더용 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 애플리케이션에서 Google 연락처 관리

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

Aspose.Email은 Gmail 연락처 작업을 지원합니다. 다음을 사용하여 IGmailClient 인터페이스를 통해 사용자는 Gmail 계정에서 연락처를 검색하고, 새 연락처를 생성하며, 기존 연락처를 업데이트 및 삭제할 수 있습니다. Gmail은 개발자가 공개 API를 사용해 이러한 작업을 수행하도록 허용합니다. Gmail 연락처 작업에 필요한 사용자 정보는 다음과 같습니다: 사용자 이름, 이메일 주소, 비밀번호, 클라이언트 ID, 클라이언트 비밀, 리프레시 토큰. 이 문서에서는 다음과 같은 방법을 보여줍니다:

Gmail 연락처 액세스

다음은 모든 그룹의 연락처 세부 정보를 액세스하는 데 사용할 수 있는 샘플 애플리케이션입니다.

Google 연락처 생성

다음 코드 조각은 Gmail에서 연락처를 생성하는 방법을 보여줍니다.

Google 연락처 업데이트

연락처를 가져온 후 속성을 업데이트하고 Gmail 계정에 다시 저장할 수 있습니다. 다음 코드 조각은 Gmail 계정에서 연락처를 검색하고, 이를 수정한 뒤 다시 저장하는 방법을 보여줍니다.

Google 연락처 삭제

Gmail 연락처를 삭제하려면 Gmail 클라이언트가 DeleteContact 방법은 다음 샘플 코드 조각에 표시된 대로 사용됩니다.

Google 연락처 저장

Aspose.Email은 MSG 및 VCF와 같은 다양한 출력 형식으로 연락처를 저장할 수 있습니다. 저장 방법은 이를 수행할 수 있는 기능을 제공합니다. 다음 코드 조각은 연락처를 저장하는 방법을 보여줍니다.

Net: Aspose.Email for .NET의 Gmail API 지원

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

IGmailClient 시작하기

Aspose.Email for .NET은 Gmail과 상호 작용하기 위한 강력한 지원을 제공합니다 IGmailClient 인터페이스. Gmail 사서함에서 메시지와 필터를 관리할 수 있습니다 — 목록 조회, 가져오기, 전송, 추가, 삭제는 물론 자동 분류를 위한 맞춤 필터 관리도 가능합니다.

Gmail 기능을 사용하려면 clientId, clientSecret, refreshToken 및 대상 이메일 주소를 사용하여 IGmailClient 인스턴스를 초기화해야 합니다. 아래 모든 예제는 이 설정을 가정합니다.

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: SMTP, IMAP 및 POP3를 통해 Gmail 이메일을 전송, 검색 및 관리

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

이 가이드에서는 Aspose.Email for .NET을 사용하여 Gmail 서버에 연결하고 이메일 보내기, 받기 및 관리와 같은 일반적인 이메일 작업을 수행하는 방법을 보여줍니다. 또한 SSL을 통한 SMTP, IMAP 및 POP3 프로토콜 사용 방법을 배울 수 있습니다.

Gmail SMTP 서버를 통한 이메일 전송

Gmail SMTP 서버에 연결

SMTP 프로토콜을 사용하여 Gmail을 통해 이메일을 보내려면, 다음의 인스턴스를 생성합니다. SmtpClient 클래스를 생성하고 연결 속성(서버 주소, 포트 번호, 자격 증명 및 보안 옵션)을 아래 코드 샘플과 같이 구성합니다.

이메일 메시지 보내기

연결이 설정되면, 이메일을 보내기 위해 다음을 생성합니다. MailMessage 객체를 만들고 이를 SmtpClient.Send() 메서드.

다음 코드 샘플은 이메일 메시지를 생성하고, 제목, 수신자 및 본문과 같은 속성을 설정한 후 Aspose.Email을 사용하여 C#에서 전송하는 방법을 보여줍니다.

IMAP 프로토콜을 사용한 이메일 관리

이 섹션에서는 Gmail 계정에 연결, 폴더 접근, 메시지 검색 및 서버에 폴더 생성과 같은 여러 IMAP 작업을 수행하는 방법을 보여줍니다.

IMAP 서버에 연결

IMAP을 통해 Gmail에 연결하려면, 다음을 사용합니다. ImapClient 클래스를 사용하여 서버, 포트 및 자격 증명을 지정합니다. Gmail은 보안 IMAP 연결을 위해 포트 993을 사용합니다.

다음 코드 샘플은 객체를 생성하고 구성하는 방법을 보여줍니다. ImapClient Gmail IMAP 서버에 보안 연결하려면:

폴더 선택 및 메시지 수 가져오기

Aspose.Email을 사용하여 Inbox 폴더에 접근하고 전체 메시지 수를 가져올 수 있습니다. SelectFolder 아래 코드 샘플에 표시된 메서드:

메시지를 로컬에 저장

폴더를 선택한 후, 다음을 사용합니다. ListMessages() 전체 메시지 요약을 가져온 다음 다운로드하고 저장 각 메시지를 EML 파일로 저장합니다. 다음 코드 샘플은 이 작업을 수행하는 방법을 보여줍니다.

새 폴더 만들기

IMAP을 사용하면 이메일 서버에 직접 폴더를 생성할 수 있습니다. Aspose.Email을 이용하면 한 줄의 코드만으로도 가능합니다:

폴더에 새 메시지 추가

특정 폴더에 메시지를 생성하고 추가하려면 다음을 사용합니다. MailMessage 및 ImapClient 클래스를 생성합니다.

아래 코드 샘플은 MailMessage 보낸 사람, 수신자, 제목 및 본문을 포함합니다. 그런 다음 IMAP 서버의 Inbox 폴더를 선택하고, 아직 구독되지 않은 경우 구독한 뒤, 생성된 메시지를 선택된 폴더에 추가합니다.

POP3 프로토콜을 사용한 이메일 검색

이 섹션에서는 POP3를 통해 Gmail 계정에 연결하고, 메일함 정보를 확인하며, SSL을 사용하여 메시지를 안전하게 다운로드하는 방법을 보여줍니다.

POP3 서버에 연결

생성하고 구성합니다. Pop3client 인스턴스를 사용하여 Gmail POP3 서버에 연결합니다. SSL 연결을 위해 포트 995를 사용합니다. 아래 코드 샘플에 과정이 표시됩니다.

메일함 상태 확인

다음 사용 GetMailboxInfo() 아래 코드 샘플에 표시된대로 메시지 수와 전체 메일함 크기를 확인하는 메서드.

메시지 정보 검색

메일함의 모든 메시지 정보를 가져오려면, 다음을 사용합니다. ListMessages() 메서드. 다음 코드 샘플은 메시지 메타데이터 컬렉션을 가져오는 방법을 보여줍니다. ListMessages(), 그런 다음 각 메시지 정보 객체를 순회하며 메시지 고유 ID, 순서 인덱스, 제목 및 크기와 같은 주요 세부 정보를 표시합니다. 이를 통해 클라이언트는 전체 이메일 내용을 다운로드하지 않고도 메시지 요약을 미리 볼 수 있습니다.

메시지 가져오기 및 저장

다음 사용 FetchMessage() 메시지를 하나씩 검색하고 .eml 파일로 로컬에 저장하는 메서드.