Gmail API 總覽

Gmail API 是 RESTful API，可用於存取 Gmail 信箱和傳送郵件。對於大多數的網路應用程式而言，Gmail API 是授權存取使用者 Gmail 資料的最佳選擇，適用於各種應用程式，例如：

  • 唯讀郵件擷取、建立索引和備份
  • 自動或透過程式傳送訊息
  • 遷移電子郵件帳戶
  • 電子郵件整理功能，包括篩選及排序郵件
  • 在整個機構中統一電子郵件簽名

常見詞彙

以下列出這個 API 中常用的字詞：

委派者和受委派者
委派者是 Gmail 使用者，可將信箱存取權授予同一 Google Workspace 機構內的其他使用者。獲得存取權的使用者是委派人員。委派代表可以讀取、傳送及刪除郵件，也可以代表委派者的帳戶查看及新增聯絡人。詳情請參閱「管理委派事項」。
草稿
未傳送的訊息。您可以取代草稿中的訊息。 傳送草稿後，系統會自動刪除草稿，並建立帶有SENT系統標籤的郵件。草稿以 drafts 資源表示。詳情請參閱「處理草稿」。
篩選器
為帳戶設定進階規則，根據特定比對條件 (例如寄件者、主旨或大小) 評估來信。如果郵件符合篩選條件，系統就會自動觸發動作，例如新增或移除標籤，或是將電子郵件轉寄至指定地址。詳情請參閱「管理篩選器」。
轉寄地址
已驗證的特定電子郵件地址，用於接收從使用者帳戶自動轉寄的郵件。如要在轉寄規則或篩選器中使用地址，必須先正式註冊並驗證地址，證明您是擁有者。詳情請參閱「管理轉寄」。
標籤

用來整理訊息和討論串的機制。舉例來說，使用者可以建立「稅務」標籤，並套用至所有與稅務相關的郵件和郵件串。詳情請參閱「管理標籤」。

標籤分為兩種類型：

系統標籤
內部建立的標籤，例如 INBOX、TRASH 或 SPAM。這些標籤無法刪除或修改。不過，部分系統標籤 (例如 INBOX) 可以套用至郵件和郵件串，或從郵件和郵件串中移除。
使用者標籤
使用者建立的標籤。使用者或應用程式可以刪除或修改這些標籤。使用者標籤由 labels 資源代表。
訊息

電子郵件訊息，包含寄件者、收件者、主旨和內文。訊息建立後即無法變更。訊息是以 messages 資源表示。

推播通知

與 Google Cloud Pub/Sub 整合的伺服器端通知系統。應用程式可以「監控」信箱，每當發生變更 (例如收到新電子郵件) 時，Gmail API 就會傳送自動 Webhook 或快訊，因此應用程式不必持續輪詢伺服器以取得更新。詳情請參閱「推播通知」。

S/MIME 憑證

上傳至特定「以其他身分傳送」別名的數位憑證，可讓使用者傳送加密及數位簽署的電子郵件，確保郵件安全和寄件者身分真實性。詳情請參閱「管理 S/MIME 憑證」。

「以別名傳送」別名

這些代表帳戶獲授權傳送郵件的各種電子郵件地址。每個帳戶至少有一個別名，代表主要電子郵件地址。別名對應於 Gmail 網頁介面中的「以這個地址傳送郵件」功能，也是設定個別地址電子郵件簽名的依據。詳情請參閱「管理別名」。

Thread

一組相關訊息，構成一則對話。在電子郵件用戶端應用程式中，當一或多名收件者回覆郵件時，就會形成會話串。詳情請參閱「管理執行緒」。