wechatpy.client.api.datacube 源代码

# -*- coding: utf-8 -*-

import datetime
from operator import itemgetter

from wechatpy.client.api.base import BaseWeChatAPI


[文档]class WeChatDataCube(BaseWeChatAPI): API_BASE_URL = "https://api.weixin.qq.com/datacube/" @classmethod def _to_date_str(cls, date): if isinstance(date, datetime.date): return date.strftime("%Y-%m-%d") elif isinstance(date, str): return date else: raise ValueError("Can not convert %s type to str", type(date))
[文档] def get_user_summary(self, begin_date, end_date): """ 获取用户增减数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/User_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getusersummary", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, ) return res["list"]
[文档] def get_user_cumulate(self, begin_date, end_date): """ 获取累计用户数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/User_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getusercumulate", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_interface_summary(self, begin_date, end_date): """ 获取接口分析数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Analytics_API.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getinterfacesummary", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_interface_summary_hour(self, begin_date, end_date): """ 获取接口分析分时数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Analytics_API.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getinterfacesummaryhour", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_article_summary(self, begin_date, end_date): """ 获取图文群发每日数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getarticlesummary", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_article_total(self, begin_date, end_date): """ 获取图文群发总数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getarticletotal", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_user_read(self, begin_date, end_date): """ 获取图文统计数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getuserread", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_user_read_hour(self, begin_date, end_date): """ 获取图文分时统计数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getuserreadhour", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_user_share(self, begin_date, end_date): """ 获取图文分享转发数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getusershare", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_user_share_hour(self, begin_date, end_date): """ 获取图文分享转发分时数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Graphic_Analysis_Data_Interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getusersharehour", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg(self, begin_date, end_date): """ 获取消息发送概况数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsg", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_hour(self, begin_date, end_date): """ 获取消息发送分时数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsghour", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_week(self, begin_date, end_date): """ 获取消息发送周数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsgweek", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_month(self, begin_date, end_date): """ 获取消息发送月数据 详情请参考 http://mp.weixin.qq.com/wiki/12/32d42ad542f2e4fc8a8aa60e1bce9838.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsgmonth", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_dist(self, begin_date, end_date): """ 获取消息发送分布数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsgdist", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_dist_week(self, begin_date, end_date): """ 获取消息发送分布周数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsgdistweek", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res
[文档] def get_upstream_msg_dist_month(self, begin_date, end_date): """ 获取消息发送分布月数据 详情请参考 https://developers.weixin.qq.com/doc/offiaccount/Analytics/Message_analysis_data_interface.html :param begin_date: 起始日期 :param end_date: 结束日期 :return: 统计数据列表 """ res = self._post( "getupstreammsgdistmonth", data={ "begin_date": self._to_date_str(begin_date), "end_date": self._to_date_str(end_date), }, result_processor=itemgetter("list"), ) return res