Zoho crm Logo

获取电子邮件草稿

目的

获取与Zoho CRM账户中的记录相关联的电子邮件草稿。

端点

  • GET /{module_API_name}/{record_ID}/__email_drafts
  • GET /{module_API_name}/{record_ID}/__email_drafts/{draft_ID}

Request 详情

Request URL

{api-domain}/crm/{version}/{module_API_name}/{record_ID}/__email_drafts

获取特定草稿:
{api-domain}/crm/{version}/{module_API_name}/{record_ID}/__email_drafts/{draft_ID}

支持的模块

潜在客户,联系人,交易,账户,销售订单,采购订单,发票,报价,案例,和自定义。

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.Modules.ALL
(or)
ZohoCRM.Modules.{module_name}.{operation_type}

可能的模块名称

潜在客户,账户,联系人,交易,报价,销售订单,采购订单,发票,案例,和自定义

可能的操作类型

全部 - 对模块的完全访问
GET - GET 模块数据

参数
  • page整数,可选

    获取相应页面的记录列表。默认值为1。 
    可能的值:仅限正整数。

  • per_page整数,可选

    获取每页可用的记录列表。默认值和最大可能值为10。
    可能的值:仅限正整数。

注意

  • 您可以在一次API调用中获取最多10封电子邮件草稿。要获取更多草稿,请使用per_page和page参数。

样本请求

Response JSON

  • schedule_detailsJSON 对象

    电子邮件的调度详细信息

    • time DateTime

      草稿的调度时间。

  • summary string

    显示邮件内容的前250个字符。

  • ccJSON array

    用于抄送电子邮件的用户名和电子邮件地址。

  • created_timedatetime

    创建电子邮件草稿的日期和时间。

  • bccJSON 数组

    用于密送电子邮件的用户名和电子邮件地址。

  • attachmentsJSON 数组

    电子邮件草稿的附件。

    • id字符串

      附件的唯一标识。

    • file_name字符串

      附件的文件名。

    • file_size字符串

      附件的大小,以兆字节为单位。

    • service_name字符串

      上传文件到ZFS的服务名称。

  • 主题字符串

    电子邮件的主题。

  • 内容字符串

    电子邮件草稿的内容。

  • modified_timedatetime

    电子邮件草稿最后修改的日期和时间。

  • reply_to电子邮件地址

    这是您希望用户在收到邮件后回复的电子邮件地址。

  • rich_text布尔值

    指定电子邮件的格式是否为富文本。可能的选项有: 
    true :富文本
    false :纯文本

  • inventory_detailsJSON 对象,可选

    表示库存模板的详细信息,如模板ID,纸张类型和视图类型。

  • fromemail address

    电子邮件草稿的发件人地址。

  • idstring

    电子邮件草稿的唯一ID。

  • toJSON array

    电子邮件草稿预计发送的用户名和电子邮件地址。

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方案: 使用HTTP GET方法来进行此API调用。使用任何其他请求方法都会导致这个错误。

  • INVALID_DATAHTTP 400

    您在请求URL中指定了无效的记录ID。
    解决方案:在请求URL中指定一个有效的记录ID。

  • INVALID_MODULEHTTP 400

    您在请求URL中指定了无效的模块API名称。
    解决方案:在请求URL中指定一个有效的模块API名称。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成具有此API所需范围的新访问令牌。请参阅此页面开头的范围部分,以获取所需范围的列表。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方案:指定一个有效的请求URL。请参考本页开头的请求URL部分以获取更多详细信息。

  • INTERNAL_ERRORHTTP 500

    服务器中出现意外且未处理的异常。 
    解决方案:联系support@zohocrm.com的支持团队。

样本回应