获取电子邮件草稿
目的
获取与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的支持团队。