在 C# 中整合 Gmail，使用 OAuth2 身份驗證和 Aspose.Email

• Aspose.Email for .NET: 在 C# 專案中的 Gmail 整合
• 取得 OAuth2 令牌以在 C# 中整合 Gmail API
  • 在 Google Cloud Console 中建立專案
  • 設定 OAuth 同意畫面
  • 建立 OAuth 憑證
  • 取得 OAuth 2.0 令牌
• 在 C# 中使用 Aspose.Email 管理 Gmail 訊息
  • 管理 Gmail 訊息的 C# 方法概覽
  • 在 C# 中傳送 Gmail 訊息
  • 使用 Aspose.Email for .NET 附加 Gmail 訊息
  • 在 C# 中擷取與刪除 Gmail 訊息
• 在 C# 中使用 Aspose.Email 管理 Gmail 篩選器
  • 建立與列出 Gmail 篩選器
  • 刪除 Gmail 篩選器

Gmail 是一個受歡迎的電子郵件服務，具備許多功能，且能與各種應用程式整合。對於 .NET 開發人員而言，將 Gmail 支援加入其應用程式可提升使用者體驗，讓使用者能直接在應用程式內管理電子郵件。

在本文中，我們將探討如何使用先進的函式庫實現無縫的 .NET Gmail 整合。我們將涵蓋發送、擷取、追加和刪除訊息等基本操作，以及管理篩選器以自動化郵件組織。無論您是需要發送自動化報告、歸檔重要郵件，或是套用篩選器來管理收件，我們的 API 都能讓這些任務變得更簡單。

在本文結束時，您將全面了解如何以程式方式管理 Gmail 訊息和篩選器，並能構建更健全且高效的電子郵件處理應用程式。

Aspose.Email for .NET: Gmail 整合於 C# 專案

Aspose.Email for .NET 是一個功能強大的庫，旨在簡化在 .NET 應用程式中整合電子郵件功能，提供對 Gmail 的全面支援。其 API 允許開發人員輕鬆管理和操作各種電子郵件格式，為在應用程式內處理電子郵件、行事曆、聯絡人等提供無縫體驗。透過使用 Aspose.Email Gmail API，開發人員可以輕鬆存取 Gmail 帳戶、發送與接收電子郵件，並以程式方式執行複雜的電子郵件操作。這不僅提升了生產力，還透過在應用程式內直接提供統一的電子郵件管理介面，增強了使用者體驗。憑藉其廣泛的功能與跨平台相容性，Aspose.Email for .NET 成為開發人員在構建具備高效 Gmail 支援的複雜應用程式時的寶貴工具。

要利用 API 的強大功能，可以 download 其 DLL 或使用以下命令從 NuGet 安裝它：

PM> Install-Package Aspose.Email

將此庫加入您的專案後，您即可開始編寫程式碼。

取得 Gmail API 整合的 OAuth2 令牌（C#）

要使用 C# 整合 Gmail 郵箱，您需要獲取 OAuth 2.0 令牌。請按照以下步驟在您的應用程式中配置 OAuth 驗證。

在 Google Cloud Console 中建立專案

1. 前往 Google Cloud Console。
2. 建立新專案或選擇現有的專案。
3. 啟用 Gmail API：
   • 前往 API & Services → Library。
   • 搜尋 Gmail API 並啟用它。

設定 OAuth 同意畫面

1. 前往 API & Services → OAuth consent screen。
2. 選擇使用者類型（內部或外部）。
3. 填寫基本資訊（app name、contact email 等）。
4. 新增所需的範圍：
   • https://mail.google.com/：對 Gmail 的完整存取權限。
   • https://www.googleapis.com/auth/gmail.readonly：唯讀存取電子郵件的權限。
   • https://www.googleapis.com/auth/gmail.send：僅允許發送電子郵件的權限。
   • https://www.googleapis.com/auth/gmail.modify：讀取並修改電子郵件（標記為已讀/未讀、刪除、移動訊息）的權限。
   • https://www.googleapis.com/auth/gmail.compose：管理草稿（建立、讀取、更新、刪除）的權限。

建立 OAuth 憑證

1. 前往 API & Services → Credentials。
2. 點擊 Create Credentials 並選擇 OAuth client ID。
3. 選擇應用程式類型（例如「Desktop app」或「Web application」）。
4. 保存 client_id 和 client_secret 以備後用。

取得 OAuth 2.0 令牌

刷新令牌 允許您的應用程式在不需要使用者重新授權的情況下獲取新的存取令牌，確保對 Gmail 的無縫且不中斷的存取。

要取得刷新令牌，請使用以下方法：

GetAccessTokenByAuthCode 方法返回 refresh token，可稍後用於在不重新執行授權流程的情況下取得新的存取權杖。

此方法的作用如下：

1. 建立 HTTP 請求：它設定一個 POST 請求至 Google OAuth 令牌端點，並使用適當的標頭和內容類型。
2. 編碼參數：客戶端 ID、客戶端密鑰、授權碼、重新導向 URI 以及授權類型會被 URL 編碼，並放入請求主體中。
3. 發送請求：該請求被送至 Google 的 OAuth 2.0 令牌端點。
4. 處理回應：回應被讀取並反序列化為 TokenResponse 物件，其中包含存取令牌和刷新令牌。

通過實作此方法，您的應用程式可以安全地獲取並使用刷新令牌，以在不反覆提示使用者授權的情況下，持續存取 Gmail。

使用 C# 與 Aspose.Email 管理 Gmail 訊息

Aspose.Email for .NET 函式庫提供管理 Gmail 訊息的方法，包括列出、擷取、發送、追加以及刪除訊息。本節提供這些操作的概述，並示範如何有效使用它們。

管理 Gmail 訊息的 C# 方法概覽

以下方法允許您以程式方式管理 Gmail 訊息：

• List Messages: 使用 ListMessages() 取得郵箱中的所有訊息，返回 GmailMessageInfo 物件的清單。
• Fetch Message: 使用 FetchMessage(string id) 取得特定訊息的完整內容，返回 MailMessage 實例。
• Send Messages: 使用 SendMessage(MailMessage msg) 直接發送訊息。
• Append Messages: 將訊息新增至 Gmail 郵箱，繞過標準分類：
  • AppendMessage(MailMessage msg) 以預設行為。
  • AppendMessage(MailMessage msg, string labelName) 以指定自訂標籤。
• Delete Messages:
  • DeleteMessage(string id, bool moveToTrash) 可將訊息移至垃圾箱或永久刪除。
  • DeleteMessage(string id) 立即永久刪除。

在 C# 中發送 Gmail 訊息

只需幾個步驟，即可將 Gmail 的電子郵件發送功能整合到您的 C# 應用程式中。以下程式碼範例將示範如何在 C# 中使用 Gmail API 發送帶附件的電子郵件。安裝 Aspose.Email 後，設定 Gmail 用戶端，建立包含所有必要細節（包括附件）的郵件訊息，最後使用 SendMessage 方法發送郵件，並收到訊息 ID 作為確認。

步驟:

1. 使用客戶端憑證和訪問令牌初始化 GmailClient。
2. 建立一個包含發件人和收件人電子郵件地址、主旨和正文的 MailMessage 物件。
3. 使用 Attachments.Add() 並指定檔案路徑，將附件加入訊息。
4. 使用 SendMessage 方法傳送訊息，該方法會回傳訊息 ID 以供確認。

程式碼範例:

使用 Aspose.Email for .NET 附加 Gmail 訊息

追加訊息允許您直接將電子郵件新增至 Gmail 信箱，繞過一般的分類。以下程式碼片段示範如何使用 Gmail 客戶端將電子郵件訊息追加至「收件匣」資料夾。它包括建立電子郵件訊息、使用特定標籤將其追加至收件匣，並透過列印訊息 ID 來確認操作成功。

步驟：

1. 使用 GmailClient.GetInstance() 方法以及必要的參數（clientId、clientSecret、refreshToken、email）建立 Gmail 客戶端的實例。
2. 建立一個 MailMessage 物件，並提供發件人電子郵件、收件人電子郵件、訊息主旨以及正文內容等詳細資訊。
3. 將訊息附加到 Inbox 資料夾。

程式碼範例:

取得並刪除 Gmail 訊息（C#）

擷取訊息可讓您存取其內容，而刪除則有助於維持郵箱的整潔。以下程式碼範例示範了使用 IGmailClient 介面與 Gmail 郵箱互動。它會列出所有電子郵件訊息，擷取並顯示前三封訊息的詳細資訊（主旨與內容），然後透過將這些訊息移至垃圾箱的方式刪除它們。

步驟：

1. 初始化 Gmail 客戶端，使用提供的憑證（clientId、clientSecret、refreshToken 和 email），透過呼叫 GmailClient.GetInstance()。
2. 使用 ListMessages() 方法檢索 Gmail 信箱中所有訊息的清單。
3. 遍歷信箱中的前三封訊息（如果有的話）。
   對於每封訊息：
   • 使用 FetchMessage(messages[i].Id) 取得訊息詳細資訊，如主旨與內容。
   • 將主旨與內容列印到主控台。
4. 透過呼叫 DeleteMessage(messages[i].Id, true) 刪除每封已處理的訊息，該操作會將訊息移至垃圾桶，仍可恢復。

程式碼範例：

使用 Aspose.Email 在 C# 中管理 Gmail 篩選器

建立與列出 Gmail 篩選器

過濾器可根據主旨或寄件者等條件協助管理收件的電子郵件。Aspose.Email CreateFilter 方法（屬於 GmailClient）定義條件與動作（例如，為重要郵件加上標籤）。ListFilters 方法會顯示套用於郵箱的所有過濾器。以下程式碼範例說明如何使用 IGmailClient 介面與 Gmail 郵箱互動。它會為具有特定主旨的電子郵件建立過濾器，為其套用標籤，並列出郵箱中所有現有的過濾器。

步驟：

1. 使用給定的憑證（clientId、clientSecret、refreshToken 和 email），透過呼叫 GmailClient.GetInstance() 來建立 GmailClient 的實例。
2. 透過建立 Filter 物件來定義訊息過濾器，設定 MatchingCriteria 以過濾主旨包含「Important」的訊息，並定義 Action 為將符合條件的訊息加上標籤「IMPORTANT」。
3. 使用 CreateFilter(filter) 方法將已定義的過濾器新增至 Gmail 帳戶。
4. 使用 ListFilters() 方法取得 Gmail 帳戶中的所有過濾器，遍歷每個過濾器並在主控台顯示其 ID。

程式碼範例:

刪除 Gmail 篩選器

當不再需要過濾器時，請將其移除。以下程式碼片段示範了使用 IGmailClient 介面連接 Gmail 帳戶、列出所有現有過濾器，然後刪除這些過濾器的過程。

步驟：

1. 初始化 Gmail 客戶端，通過建立 GmailClient 的實例並提供必要的憑證（clientId、clientSecret、refreshToken 和 email），調用 GmailClient.GetInstance()。
2. 透過呼叫 ListFilters() 方法檢索現有的過濾器。它會取得目前在 Gmail 信箱中設定的所有過濾器清單。
3. 迭代取得的過濾器清單中的每個過濾器。
4. 對於每個過濾器，執行 DeleteFilter(filter.Id) 以將其從 Gmail 帳戶中移除。
5. 為每個已刪除的過濾器在控制台打印確認訊息，指出被移除的具體過濾器 ID。

程式碼範例:

結論

在本文中，我們介紹了使用 Aspose.Email Gmail API 將 Gmail 功能整合到 .NET 應用程式中的方法。按照所列步驟，您可以在 C# 中有效實作 OAuth2 驗證，從而安全存取 Gmail 帳戶。Aspose.Email for .NET 提供的完整功能允許開發人員管理 Gmail 訊息、自動化電子郵件任務並增強應用程式功能。無論您需要傳送、擷取、追加或刪除 Gmail 訊息，C# 中的 Gmail API 與 .NET Gmail 整合的結合，都為您的 C# 專案提供了強大的電子郵件管理解決方案。

請參考我們的免費公共資源：

• API 參考 提供關於類別和方法的深入資訊。
• 文件 提供包含範例的完整指南。
• 支援論壇 允許使用者尋求協助並討論問題。
• 部落格 提供更新、教學和最佳實踐。

今天就開始使用 Aspose.Email for .NET！

另見

• 使用 OAuth2 驗證的 IMAP 存取 Gmail（C#）
• Gmail 產生器 - 建立臨時一次性 Gmail
• 在 C# 中建立、更新或刪除 Google 行事曆