跳到主要内容

更新邮件草稿

POST/v2/users/:email/messages/:id

根据邮件 ID 更新指定用户草稿箱中的邮件。仅支持更新草稿邮件，请求中的只读字段不会被写入。

Request​

Path parameters

    email stringrequired

    用户的邮箱地址

    id stringrequired

    邮件唯一标识

Query parameters

    $select string

请求体参数

    message object

    需要更新的邮件信息，未填写的字段保持不变

    internetMessageId string

    由RFC2822指定格式的邮件消息Id（可选字段：在URL中增加$select=internetMessageId查询参数后返回，如需多个字段使用英文逗号分隔）

    subject string

    邮件主题

    summary string

    邮件摘要信息

    priority enum

    邮件的重要性, 值可以是 HIGH、NORMAL、LOW，默认为NORMAL

    • PRY_HIGH:
    • PRY_NORMAL:

    Possible values: [PRY_HIGH, PRY_NORMAL]

    isReadReceiptRequested boolean

    是否需要已读回执，默认为false（可选字段：在URL中增加$select=isReadReceiptRequested查询参数后返回，如需多个字段使用英文逗号分隔）

    from object

    发送邮件邮箱的所有者，在多数情况中，此数值与“sender”属性相同

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    toRecipients object[]

    邮件的收件人（可选字段：在URL中增加$select=toRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    ccRecipients object[]

    邮件的抄送收件人（可选字段：在URL中增加$select=ccRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    bccRecipients object[]

    邮件的密送收件人（可选字段：在URL中增加$select=bccRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    replyTo object[]

    在答复时使用的邮件地址（可选字段：在URL中增加$select=replyTo查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    body object

    邮件正文，可以是html格式和文本格式的组合（可选字段：在URL中增加$select=body查询参数后返回，如需多个字段使用英文逗号分隔）

    bodyText string

    邮件文本格式正文

    bodyHtml string

    邮件html格式正文

    internetMessageHeaders object

    由RFC5322定义的邮件头集合

    property name* string

    由RFC5322定义的邮件头集合

    tags string[]

    邮件标签列表（可选字段：在URL中增加$select=tags查询参数后返回，如需多个字段使用英文逗号分隔）

响应

    message object

    更新后的邮件信息, 仅包括最简单的信息和受本次更新影响的部分字段

    internetMessageId string

    由RFC2822指定格式的邮件消息Id（可选字段：在URL中增加$select=internetMessageId查询参数后返回，如需多个字段使用英文逗号分隔）

    subject string

    邮件主题

    summary string

    邮件摘要信息

    priority enum

    邮件的重要性, 值可以是 HIGH、NORMAL、LOW，默认为NORMAL

    • PRY_HIGH:
    • PRY_NORMAL:

    Possible values: [PRY_HIGH, PRY_NORMAL]

    isReadReceiptRequested boolean

    是否需要已读回执，默认为false（可选字段：在URL中增加$select=isReadReceiptRequested查询参数后返回，如需多个字段使用英文逗号分隔）

    from object

    发送邮件邮箱的所有者，在多数情况中，此数值与“sender”属性相同

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    toRecipients object[]

    邮件的收件人（可选字段：在URL中增加$select=toRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    ccRecipients object[]

    邮件的抄送收件人（可选字段：在URL中增加$select=ccRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    bccRecipients object[]

    邮件的密送收件人（可选字段：在URL中增加$select=bccRecipients查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    sender object

    实际用于生成邮件的帐户，大多数情况下，此值与“from”属性相同，在任何情况下，此值必须对应于使用的实际邮箱（可选字段：在URL中增加$select=sender查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    replyTo object[]

    在答复时使用的邮件地址（可选字段：在URL中增加$select=replyTo查询参数后返回，如需多个字段使用英文逗号分隔）

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    body object

    邮件正文，可以是html格式和文本格式的组合（可选字段：在URL中增加$select=body查询参数后返回，如需多个字段使用英文逗号分隔）

    bodyText string

    邮件文本格式正文

    bodyHtml string

    邮件html格式正文

    internetMessageHeaders object

    由RFC5322定义的邮件头集合

    property name* string

    由RFC5322定义的邮件头集合

    folderId string

    邮件所属文件夹唯一标识

    id string

    邮件唯一标识

    hasAttachments boolean

    指明邮件是否含有附件(不包括inline资源)

    isRead boolean

    指明邮件是否已读

    conversationId string

    邮件所属会话唯一标识

    sentDateTime string<date-time>

    邮件发送时间

    lastModifiedDateTime string<date-time>

    邮件最后修改时间（可选字段：在URL中增加$select=lastModifiedDateTime查询参数后返回，如需多个字段使用英文逗号分隔）

    receivedDateTime string<date-time>

    收件人接收该邮件的时间（可选字段：在URL中增加$select=receivedDateTime查询参数后返回，如需多个字段使用英文逗号分隔）

    tags string[]

    邮件标签列表（可选字段：在URL中增加$select=tags查询参数后返回，如需多个字段使用英文逗号分隔）

    isReplied boolean

    指明邮件是否已回复

    isForwarded boolean

    指明邮件是否已转发

    sendStatus enum

    邮件发送状态（可选字段：在URL中增加$select=sendStatus查询参数后返回，如需多个字段使用英文逗号分隔）

    • none:
    • posting:
    • partial_success:
    • success:
    • failed:
    • unknown:

    Possible values: [none, posting, partial_success, success, failed, unknown]

    size number<int64>

    邮件大小（字节）

错误

401

访问未授权，请检查是否传递了正确的授权token

403

无API访问权限，请在域管的应用管理页面完成相关授权