Gmail API 版本資訊:2014 年至 2019 年

本頁包含 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() 現在會在 messagesAddedmessagesDeletedlabelsAddedlabelsRemoved 中傳回目前所有的 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 範圍,以便更妥善保護使用者,並發布不需要完整信箱資料存取權的應用程式:

2015 年 3 月 18 日:插入訊息的新選項

messages.insert() 現在支援 deleted 要求參數,並允許設定 SENTDRAFT 標籤。

2015 年 2 月 25 日:記錄清單瞭解詳情

history.list() 現在提供每個記錄記錄中變更類型的詳細資料。例如,使用 messagesAddedmessagesDeletedlabelsAddedlabelsDeleted,很容易地傳達訊息變更,通常不需要其他呼叫來同步處理用戶端。

2015 年 2 月 11 日:匯入郵件的新選項

messages.import() 現在支援三個新參數,以更好支援 Email Migration 用途。請參閱 messages.import() 文件,瞭解如何使用新的 neverMarkSpamprocessForCalendardeleted 要求參數。

2015 年 1 月 23 日:郵件匯入標籤支援和預設變更

您現在可以在 messages.import() 要求中指定 message.labelIds,讓系統自動將指定的標籤套用至訊息。

因此,接下來幾週內,預設行為將停止自動為 messages.import() 電子郵件新增 INBOXUNREAD 標籤;如未指定 message.labelIds,則匯入的郵件只會顯示在「所有郵件」中。如果想套用 INBOX 和/或 UNREAD 標籤,請在 message.labelIds 欄位中指定這些標籤。

2015 年 1 月 15 日:每人增加配額

預設 per-user quotas 已從每位使用者 25 單位增加至每位使用者 250 個單位,部分方法費用會略做調整。

2014 年 10 月 22 日:用於擷取執行緒的新格式參數

您現在可以指定 threads.get() 的傳回格式。可用的格式為 fullmetadataminimal,類似於 messages.get() 方法。請注意,threads.get() 不允許 raw 格式,以避免意外傳回大量的資料。

2014 年 10 月 16 日:New GetProfile 方法

現已提供新的 getProfile() 方法。這項服務提供整個信箱的資訊,例如目前的記錄 ID,以及訊息和執行緒總數。

2014 年 10 月 6 日:新的「重要」標籤和新欄位可用於計算已加上特定標籤的郵件

我們新增了 IMPORTANT 標籤,以對應至 Gmail 網頁介面的功能。

此外,我們也在標籤資源中新增了四個欄位,以便簡化套用特定標籤的郵件數量。

新欄位包括:messagesTotalmessagesUnreadthreadsTotalthreadsUnread

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 已公開使用!