本頁包含 Gmail API 2019 年版本資訊。
2019 年 11 月 12 日 New message.import() 實作
messages.import()
現已實作效能更佳的後端實作。新版本與先前的實作相容,且所有用戶端都會在幾週前自動使用新行為啟動。新的後端可以有效支援平行的 message.import()
呼叫,而用戶端現在可以同時匯入訊息,讓使用者享有更高的遷移處理量。已調降 message.import() API 方法的配額費用,以反映新的效能。
2017 年 2 月 7 日 history.list() 的記錄類型篩選
history.list()
現在支援按類型篩選記錄記錄。
2016 年 11 月 30 日 New messages.batchModified() 方法
messages.batchModify()
是一種新方法,可讓您在單一批次作業中,依訊息 ID 修改多封郵件的標籤。
2016 年 11 月 1 日:新中繼資料範圍
Gmail API 現在支援新的 gmail.metadata 範圍。這個範圍可讓開發人員存取使用者的信箱,包括記錄記錄、標籤和電子郵件標頭,但無法提供電子郵件內文或附件。
2016 年 7 月 1 日:新的端點設定
我們推出了多個新的郵件管理端點設定。詳情請參閱下列指南:
此外,drafts.list()
還提供新的要求參數 q
,可將結果範圍限制在符合指定查詢的訊息。
2016 年 2 月 25 日:New messages.batchDelete() 方法
messages.batchDelete()
是一種新方法,可讓您在單一批次作業中依訊息 ID 刪除多則訊息。
2016 年 1 月 13 日:New draft for draft.list()
drafts.list()
現在提供新選項:includeSpamRow,可用於判斷回應是否應套用含有垃圾郵件和垃圾桶標籤的草稿。此選項目前預設為 true,但我們計劃盡快將其變更為 false。
2015 年 6 月 22 日:logs.list() 的標籤
history.list()
現在會在 messagesAdded
、messagesDeleted
、labelsAdded
和 labelsRemoved
中傳回目前所有的 Message.labelIds
,因此您可以輕鬆在變更前後瞭解電子郵件的完整狀態。
2015 年 6 月 18 日:Message InternalDate 欄位
新增 Message.internalDate
欄位,顯示信箱中的訊息建立時間戳記。
2015 年 5 月 29 日:Gmail API 推播通知
Gmail API 現已支援傳送信箱更新的推播通知,不需要即時輪詢,即可即時提供伺服器通知。舉例來說,您現在可以透過 Cloud Pub/Sub 使用 Webhook,這樣就能在更新時接收回呼。 此外,這些通知也可以篩選出特定的 Gmail 標籤。如要開始使用,請參閱推播通知指南。
2015 年 3 月 31 日:新增標籤和插入郵件範圍
我們推出了兩種更精細的 ACL 範圍,以便更妥善保護使用者,並發布不需要完整信箱資料存取權的應用程式:
https://www.googleapis.com/auth/gmail.insert
:僅允許messages.insert()
和messages.import()
。https://www.googleapis.com/auth/gmail.labels
:僅允許all label operations
。
2015 年 3 月 18 日:插入訊息的新選項
messages.insert()
現在支援 deleted
要求參數,並允許設定 SENT
和 DRAFT
標籤。
2015 年 2 月 25 日:記錄清單瞭解詳情
history.list()
現在提供每個記錄記錄中變更類型的詳細資料。例如,使用 messagesAdded
、messagesDeleted
、labelsAdded
或 labelsDeleted
,很容易地傳達訊息變更,通常不需要其他呼叫來同步處理用戶端。
2015 年 2 月 11 日:匯入郵件的新選項
messages.import()
現在支援三個新參數,以更好支援 Email Migration
用途。請參閱 messages.import()
文件,瞭解如何使用新的 neverMarkSpam
、processForCalendar
和 deleted
要求參數。
2015 年 1 月 23 日:郵件匯入標籤支援和預設變更
您現在可以在 messages.import()
要求中指定 message.labelIds
,讓系統自動將指定的標籤套用至訊息。
因此,接下來幾週內,預設行為將停止自動為 messages.import()
電子郵件新增 INBOX
和 UNREAD
標籤;如未指定 message.labelIds
,則匯入的郵件只會顯示在「所有郵件」中。如果想套用 INBOX
和/或 UNREAD
標籤,請在 message.labelIds
欄位中指定這些標籤。
2015 年 1 月 15 日:每人增加配額
預設 per-user quotas
已從每位使用者 25 單位增加至每位使用者 250 個單位,部分方法費用會略做調整。
2014 年 10 月 22 日:用於擷取執行緒的新格式參數
您現在可以指定 threads.get()
的傳回格式。可用的格式為 full
、metadata
和 minimal
,類似於 messages.get()
方法。請注意,threads.get()
不允許 raw
格式,以避免意外傳回大量的資料。
2014 年 10 月 16 日:New GetProfile 方法
現已提供新的 getProfile()
方法。這項服務提供整個信箱的資訊,例如目前的記錄 ID,以及訊息和執行緒總數。
2014 年 10 月 6 日:新的「重要」標籤和新欄位可用於計算已加上特定標籤的郵件
我們新增了 IMPORTANT
標籤,以對應至 Gmail 網頁介面的功能。
此外,我們也在標籤資源中新增了四個欄位,以便簡化套用特定標籤的郵件數量。
新欄位包括:messagesTotal
、messagesUnread
、threadsTotal
和 threadsUnread
。
2014 年 9 月 8 日:提供新的訊息格式
我們變更了 messages.get()
。您現在可以要求 metadata
傳回格式,只傳回電子郵件標頭和中繼資料,例如 ID 和標籤。
2014 年 9 月 2 日:變更為內部日期行為
您現在可以同時為 messages.insert()
和 messages.import()
指定 internalDateSource
。
我們想要將這個旗標的預設行為改為較直覺,並希望在 2014 年 9 月 15 日變更預設行為。此後,messages.insert()
會預設為使用 receivedTime
,而 messages.import()
預設會使用 dateHeader
。如果您關心 messages.insert()
或 messages.import()
的內部日期來源,請務必在此日期之前指定此要求查詢參數。
2014 年 7 月 11 日:更新方法配額費用
API 中所有方法的配額費用均已降低 10。舉例來說,如果方法原本使用 150 個配額單位,現在費用為 15。如需 API 方法費用的完整清單,請參閱個別方法配額用量圖表。
2014 年 6 月 25 日:Gmail API 現已推出!
Gmail API 已公開使用!