草稿表示应用了 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
。