Gmail API 總覽

Gmail API 是符合 REST 樣式的 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 網頁介面的「以這個地址傳送郵件」功能，也是設定個別地址電子郵件簽名的依據。詳情請參閱「管理別名」。

執行緒

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