以下objects与report
API直接相关。
报告object具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
reportid | string | (只读) 报告的ID。 |
userid (required) |
string | 创建报告的用户ID。 |
name (required) |
string | 报告的唯一名称。 |
dashboardid (required) |
string | 报告所基于的仪表板ID。 |
period | integer | 报告生成的时间范围。 可选值: 0 - (默认) 前一天; 1 - 前一周; 2 - 前一月; 3 - 前一年。 |
cycle | integer | 报告重复生成的时间计划。 可选值: 0 - (默认) 每天; 1 - 每周; 2 - 每月; 3 - 每年。 |
start_time | integer | 每天生成报告的时间(以秒为单位)。 默认值:0。 |
weekdays | integer | 每周发送报告的日期。 仅适用于周报。 位图可选值: 1 - 周一; 2 - 周二; 4 - 周三; 8 - 周四; 16 - 周五; 32 - 周六; 64 - 周日。 这是一个位掩码字段;可以接受任何位图值的组合(例如,21表示周一、周三和周五)。 默认值:0。 |
active_since | string | 开始日期。 可选值: 空string - (默认) 未指定(存储为0); YYYY-MM-DD格式的具体日期(存储为一天开始的时间戳(00:00:00))。 |
active_till | string | 结束日期。 可选值: 空string - (默认) 未指定(存储为0); YYYY-MM-DD格式的具体日期(存储为一天结束的时间戳(23:59:59))。 |
subject | string | 报告消息主题。 |
message | string | 报告消息正文。 |
status | integer | 报告是否启用。 可选值: 0 - 禁用; 1 - (默认) 启用。 |
description | text | 报告描述。 |
state | integer | (只读) 报告状态。 可选值: 0 - (默认) 报告尚未处理; 1 - 报告已生成并成功发送给所有收件人; 2 - 报告生成失败;"info"包含错误信息; 3 - 报告已生成,但发送给部分(或全部)收件人失败;"info"包含错误信息。 |
lastsent | timestamp | (只读) 上次成功发送报告的Unix时间戳。 |
info | string | (只读) 错误描述或附加信息。 |
请注意,某些方法(更新、删除)所需/可选参数的组合有所不同。
用户object具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
userid (required) |
string | 接收报告的用户ID |
access_userid | string | 代表生成报告的用户ID 0 - (默认) 由收件人生成报告 |
exclude | integer | 是否从邮件列表中排除该用户 可选值: 0 - (默认) 包含; 1 - 排除 |
用户组 object 具有以下属性:
属性 | 数据类型 | 描述 |
---|---|---|
usrgrpid (required) |
string | 接收报告的用户组ID。 |
access_userid | string | 代表生成报告的用户ID。 0 - (默认) 由接收者生成报告。 |