草稿代表已套用 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
設定為要傳送的新 MIME 訊息,然後將 draft.message.raw
欄位設為以 Base64url 編碼字串編碼的新 MIME 訊息。詳情請參閱 drafts.send
的說明。