datacube

type ArticleBaseData struct {
	IntPageReadUser  int `json:"int_page_read_user"`  // 图文页(点击群发图文卡片进入的页面)的阅读人数
	IntPageReadCount int `json:"int_page_read_count"` // 图文页的阅读次数
	OriPageReadUser  int `json:"ori_page_read_user"`  // 原文页(点击图文页"阅读原文"进入的页面)的阅读人数, 无原文页时此处数据为0
	OriPageReadCount int `json:"ori_page_read_count"` // 原文页的阅读次数
	ShareUser        int `json:"share_user"`          // 分享的人数
	ShareCount       int `json:"share_count"`         // 分享的次数
	AddToFavUser     int `json:"add_to_fav_user"`     // 收藏的人数
	AddToFavCount    int `json:"add_to_fav_count"`    // 收藏的次数
}

type ArticleSummaryData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!

	// 这里的msgid实际上是由msgid(图文消息id)和index(消息次序索引)组成,
	// 例如12003_3,  其中12003是msgid, 即一次群发的id消息的;
	// 3为index, 假设该次群发的图文消息共5个文章(因为可能为多图文),  3表示5个中的第3个
	MsgId string `json:"msgid"`
	Title string `json:"title"` // 图文消息的标题
	ArticleBaseData
}

type ArticleTotalData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	MsgId      string `json:"msgid"`       // 同 ArticleSummaryData.MsgId
	Title      string `json:"title"`
	Details    []struct {
		StatDate   string `json:"stat_date"`   // 统计的日期, 在getarticletotal接口中, ref_date指的是文章群发出日期,  而stat_date是数据统计日期
		TargetUser int    `json:"target_user"` // 送达人数, 一般约等于总粉丝数(需排除黑名单或其他异常情况下无法收到消息的粉丝)
		ArticleBaseData
	} `json:"details"`
}

type InterfaceSummaryData struct {
	RefDate       string `json:"ref_date"`        // 数据的日期, YYYY-MM-DD 格式
	CallbackCount int    `json:"callback_count"`  // 通过服务器配置地址获得消息后, 被动回复用户消息的次数
	FailCount     int    `json:"fail_count"`      // 上述动作的失败次数
	TotalTimeCost int64  `json:"total_time_cost"` // 总耗时, 除以callback_count即为平均耗时
	MaxTimeCost   int64  `json:"max_time_cost"`   // 最大耗时
}

type InterfaceSummaryHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	InterfaceSummaryData
}

type Request struct {
	// 获取数据的起始日期, YYYY-MM-DD 格式;
	// begin_date 和 end_date 的差值需小于"最大时间跨度"(比如最大时间跨度为1时,
	// begin_date 和 end_date 的差值只能为0, 才能小于1), 否则会报错.
	BeginDate string `json:"begin_date,omitempty"`

	// 获取数据的结束日期, YYYY-MM-DD 格式;
	// end_date 允许设置的最大值为昨日.
	EndDate string `json:"end_date,omitempty"`
}

type UpstreamMsgData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!

	// 消息类型, 代表含义如下:
	// 1代表文字
	// 2代表图片
	// 3代表语音
	// 4代表视频
	// 6代表第三方应用消息(链接消息)
	MsgType  int `json:"msg_type"`
	MsgUser  int `json:"msg_user"`  // 上行发送了(向公众号发送了)消息的用户数
	MsgCount int `json:"msg_count"` // 上行发送了消息的消息总数
}

type UpstreamMsgDistData struct {
	RefDate       string `json:"ref_date"`       // 数据的日期, YYYY-MM-DD 格式
	UserSource    int    `json:"user_source"`    // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	CountInterval int    `json:"count_interval"` // 当日发送消息量分布的区间, 0代表 "0", 1代表"1-5", 2代表"6-10", 3代表"10次以上"
	MsgUser       int    `json:"msg_user"`       // 上行发送了(向公众号发送了)消息的用户数
}

type UpstreamMsgDistMonthData UpstreamMsgDistData

type UpstreamMsgDistWeekData UpstreamMsgDistData

type UpstreamMsgHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	UpstreamMsgData
}

type UpstreamMsgMonthData UpstreamMsgData

type UpstreamMsgWeekData UpstreamMsgData

type UserCumulateData struct {
	RefDate      string `json:"ref_date"`      // 数据的日期, YYYY-MM-DD 格式
	UserSource   int    `json:"user_source"`   // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	CumulateUser int    `json:"cumulate_user"` // 总用户量
}

type UserReadData struct {
	RefDate    string `json:"ref_date"` // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"`
	ArticleBaseData
}

type UserReadHourData struct {
	RefHour         int   `json:"ref_hour"`          // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	TotalOnlineTime int64 `json:"total_online_time"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	UserReadData
}

type UserShareData struct {
	RefDate    string `json:"ref_date"`    // 数据的日期, YYYY-MM-DD 格式
	UserSource int    `json:"user_source"` // 返回的 json 有这个字段, 文档中没有, 都是 0 值, 可能没有实际意义!!!
	ShareScene int    `json:"share_scene"` // 分享的场景, 1代表好友转发 2代表朋友圈 3代表腾讯微博 255代表其他
	ShareCount int    `json:"share_count"` // 分享的次数
	ShareUser  int    `json:"share_user"`  // 分享的人数
}

type UserShareHourData struct {
	RefHour int `json:"ref_hour"` // 数据的小时, 包括从000到2300, 分别代表的是[000,100)到[2300,2400), 即每日的第1小时和最后1小时
	UserShareData
}

type UserSummaryData struct {
	RefDate string `json:"ref_date"` // 数据的日期, YYYY-MM-DD 格式

	// 用户的渠道, 数值代表的含义如下:
	// 0  代表其他
	// 1  xxx(文档没有说明)
	// 2  xxx(文档没有说明)
	// 3  代表扫二维码
	// 4  xxx(文档没有说明)
	// 5  xxx(文档没有说明)
	// 17 代表名片分享
	// 35 代表搜号码(即微信添加朋友页的搜索)
	// 39 代表查询微信公众帐号
	// 43 代表图文页右上角菜单
	UserSource int `json:"user_source"`

	NewUser    int `json:"new_user"`    // 新增的用户数量
	CancelUser int `json:"cancel_user"` // 取消关注的用户数量, new_user 减去 cancel_user即为净增用户数量
}