草稿代表已套用 DRAFT
系統標籤的未傳送郵件。草稿包含的訊息在建立後就無法編輯,但可以取代。在此情況下,「草稿資源」只是提供穩定 ID 的容器,因為每次取代訊息時都會變更基礎訊息 ID。
草稿內的訊息資源行為與其他訊息類似,但以下差異除外:
- 草稿郵件不得含有「
DRAFT
」系統標籤以外的任何標籤。 - 傳送草稿後,系統會自動刪除草稿,並使用
SENT
系統標籤建立具備更新 ID 的新訊息。這則訊息會在drafts.send
回應中傳回。
目錄
建立郵件草稿
應用程式可以使用 drafts.create 方法建立草稿。一般程序如下:
下列程式碼範例呈現了這項程序。
Java
Python
正在更新草稿
與建立草稿類似,如要更新草稿,您必須在要求主體中提供 Draft
資源,並將 draft.message.raw
欄位設為包含 MIME 訊息的 Base64url 編碼字串。因為無法更新訊息,系統會刪除草稿中的訊息,並由更新要求中提供的新 MIME 訊息取代。
您可以使用 format=raw
參數呼叫 drafts.get
,擷取草稿中包含的目前 MIME 郵件。
詳情請參閱
drafts.update
。
正在傳送草稿
傳送草稿時,您可以選擇直接傳送訊息,或是直接傳送更新後的訊息。如果您要以新訊息更新草稿內容,請在 drafts.send
要求的內文中提供 Draft
資源、設定要傳送的草稿的 draft.id
,以及將 draft.message.raw
欄位設定為以 Base64url 編碼字串編碼的新 MIME 訊息。詳情請參閱 drafts.send
。