日志查询字段全解析：精准定位与管理钉钉企业邮箱操作记录

概要说明

操作日志详情目前是以英文为主，大部分字段的含义是可以从字面含义和上下文中获得的。格式以key-value对组成。相对原来的操作日志，升级后的日志详情提供了更多的操作细节，但仍有许多不够完善的地方，我们会持续迭代。

部分日志详情最外层字段为request和response, 对应这次操作的请求内容体和返回内容体。

注意：这类日志对于批量操作可能会出现日志被载断的现象。

request

request中包含操作者operatorEmail和被操作的对象（及列表）, 以及操作的内容, 如属性变更等。

response

response中包括操作的结果, respStatus对象表示这次操作的返回值及错误码信息。

对于批量操作还会返回成功失败列表, 其中success表示操作成功的对象列表, fail表示操作失败的对象列表。

下面按照操作类型分别说明request中特殊的参数。

1、用户

用户更新

request请求中status=0表示恢复用户状态到正常

request请求中status=1表示冻结用户邮箱

response响应中"success"有对应邮箱地址，代表操作成功，失败的会出现在"fail"中

{
    "request": {
        "accounts": [
            {
                "email": "xxx@xxx.dingmail.work",
                "status": 1 #0是正常状态,1是冻结状态
            }
        ],
        "operationEmail": ""
    },
    "response": {
        "success": [
            {
                "email": "xxx@xxx.dingmail.work"
            }
        ],
        "fail": [],
        "respStatus": {
            "statusMsg": "SYS_RESP_OK",
            "statusCode": 100
        }
    }
}

{
    "request": {
        "accounts": [
            {
                "email": "xxx@xxx.dingmail.work",
                "status": 0
            }
        ],
        "operationEmail": ""
    },
    "response": {
        "success": [
            {
                "email": "xxx@xxx.dingmail.work"
            }
        ],
        "fail": [],
        "respStatus": {
            "statusMsg": "SYS_RESP_OK",
            "statusCode": 100
        }
    }
}

{
    "request": {
        "blockTypeAndNum": "",
        "operationEmail": "",
        "reason": "xxx.dingmail.work",
        "receiveRestriction": 0,#0是不限制邮件接收，1是限制邮件接收
        "sendRestriction": 0 #0是不限制邮件发送，1是限制邮件发送
    },
    "response": {
        "respStatus": {
            "statusMsg": "SYS_RESP_OK",
            "statusCode": 100
        }
    }
}

用户密码更新

钉钉企业邮箱默认一键登录，后续功能迭代。

2、邮件组

相关字段

address 地址
name 名称
description 描述
type 类型 0普通邮件组 1部门邮件组 2动态邮件组 4群组
status 状态0正常，1冻结
admin 管理员
maxAccountNum 最大账号数
needApprove 是否需要审核
contactShare 是否在通讯录中显示此邮件组
newMemberNotice 添加组成员后，是否发送通知给新成员

邮件组创建

{
    "email": "xxx@xxx.dingmail.work"
}

邮件组删除

addresses 邮件组列表

邮件组更新

例如：

邮件组成员添加/邮件组成员删除

address 邮件组地址

members 成员列表

3、邮件

邮件删除

"method": "delete mail"

其他字段说明参考邮件移动示例。

邮件移动

"method": "move mail"

例如，从收件箱“inbox”移动到已删除“deleted”文件夹

{
    "envId": "---.UpSUHnb",
    "folderName": "inbox",#源文件夹
    "from": "\"xxx\" <xxx@xxx.dingmail.work>",#邮件的发件人
    "mailDate": "Wed, 27 Sep 2023 13:59:04 +0800",#邮件的时间，非移动时间
    "mailId": "2_0:DzzzzyOv1hL$---.UpSUHnb",
    "mailSize": 2020,#邮件大小
    "mboxid": "----2E-----H01cWY",
    "messageId": "d7e03c56-9ccb-45bc-a976-a4cc71d0b30d.xxx@xxx.dingmail.work",
    "method": "move mail",#操作事件为移动邮件
    "stableMimeId": "DzzzzzzNqZw",
    "subject": "xxx",#邮件主题
    "targetFolderName": "deleted",#目标文件夹
    "to": "\"xxx\" <xxx@xxx.dingmail.work>"#邮件的收件人
}

邮件彻底删除

暂无

邮件撤回

暂无

4、后台管理

安全问题设置

暂无

安全手机绑定

securityMobile 手机号码

安全手机解绑

暂无

邮件传输规则创建

暂无

邮件传输规则删除

暂无

邮件传输规则更新

item 规则明细, 包括监控转发, 审核, 过滤

三方应用创建/删除/更新

method newApp增加应用, deleteApp删除应用

appName 应用名

appCode 应用code

NewAppRequest 增加应用信息

DeleteAppRequest 删除应用信息

GrantAppPermissionsRequest 应用授权信息

日志导出/账号导出

{
    "attachmentName": "日志导出_2023-10-08 10:11:56.csv",#日志导出的文件名（邮件中的附件名）
    "receivers": "xxx@xxx.dingmail.work",#日志导出的收件人
    "subject": "日志导出_2023-10-08 10:11:56"#日志邮件主题
}