日志接口

class dingtalk.client.api.Report(client=None)

comment_list(report_id, offset=0, size=20)

获取日志评论详情

参数:

• report_id – 日志id
• offset – 分页查询的游标，最开始传0，后续传返回参数中的next_cursor值，默认值为0
• size – 分页参数，每页大小，最多传20，默认值为20

getunreadcount(userid='')

查询企业员工的日志未读数

参数:userid – 员工id

list(start_time, end_time, cursor=0, size=20, template_name='', userid='')

查询企业员工发出的日志列表

参数:

• start_time – 查询起始时间
• end_time – 查询截止时间
• cursor – 查询游标，初始传入0，后续从上一次的返回值中获取
• size – 每页数据量
• template_name – 要查询的模板名称
• userid – 员工的userid

receiver_list(report_id, offset=0, size=100)

获取日志分享人员列表

参数:

• report_id – 日志id
• offset – 分页查询的游标，最开始传0，后续传返回参数中的next_cursor值，默认值为0
• size – 分页参数，每页大小，最多传100，默认值为100

statistics(report_id)

获取日志统计数据

参数:report_id – 日志id

statistics_listbytype(report_id, _type, offset=0, size=100)

根据类型获取日志相关人员列表

参数:

• report_id – 日志id
• _type – 查询类型 0:已读人员列表 1:评论人员列表 2:点赞人员列表
• offset – 分页查询的游标，最开始传0，后续传返回参数中的next_cursor值，默认值为0
• size – 分页参数，每页大小，最多传100，默认值为100

template_listbyuserid(userid='', offset=0, size=100)

根据用户id获取可见的日志模板列表

参数:

• userid – 员工userId, 不传递表示获取所有日志模板
• offset – 分页游标，从0开始。根据返回结果里的next_cursor是否为空来判断是否还有下一页，且再次调用时offset设置成next_cursor的值
• size – 分页大小，最大可设置成100