“草稿”表示已应用 DRAFT
系统标签的未发送邮件。草稿中包含的消息一经创建便无法修改,但可以替换。从这个意义上讲,草稿资源只是提供稳定 ID 的容器,因为每当消息被替换时,底层消息 ID 都会发生变化。
草稿中的消息资源的行为与其他消息类似,但存在以下差异:
- 草稿消息不得带有
DRAFT
系统标签以外的任何标签。 - 草稿发送后,系统会自动删除草稿,并使用
SENT
系统标签创建一个具有更新 ID 的新消息。此消息会在drafts.send
响应中返回。
目录
创建草稿邮件
您的应用可以使用 drafts.create 方法创建草稿。一般流程如下:
以下代码示例演示了该过程。
Java
Python
更新草稿
与创建草稿类似,如需更新草稿,您必须在请求正文中提供 Draft
资源,并将 draft.message.raw
字段设置为包含 MIME 邮件的 base64url 编码字符串。由于无法更新邮件,草稿中包含的邮件会被销毁,并替换为更新请求中提供的新 MIME 邮件。
您可以通过调用 drafts.get
并使用参数 format=raw
来检索草稿中包含的当前 MIME 邮件。
如需了解详情,请参阅 drafts.update
。
发送草稿
发送草稿时,您可以选择按原样发送邮件,也可以发送更新后的邮件。如果您要使用新邮件更新草稿内容,请在 drafts.send
请求的正文中提供 Draft
资源;设置要发送的草稿的 draft.id
;并将 draft.message.raw
字段设置为编码为 base64url 编码字符串的新 MIME 邮件。如需了解详情,请参阅 drafts.send
。