🎨 #2028 【公众号】获取图文群发总数据接口返回增加确实字段

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpDataCubeService.java

@@ -24,6 +24,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate   最大时间跨度7天，endDate不能早于begingDate
+   * @return the user summary
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeUserSummary> getUserSummary(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -36,6 +38,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate   最大时间跨度7天，endDate不能早于begingDate
+   * @return the user cumulate
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeUserCumulate> getUserCumulate(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -50,6 +54,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate   最大时间跨度1天，endDate不能早于begingDate
+   * @return the article summary
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleResult> getArticleSummary(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -61,6 +67,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度1天，endDate不能早于begingDate
+   * @return the article total
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleTotal> getArticleTotal(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -72,6 +80,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度3天，endDate不能早于begingDate
+   * @return the user read
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleResult> getUserRead(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -83,6 +93,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度1天，endDate不能早于begingDate
+   * @return the user read hour
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleResult> getUserReadHour(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -94,6 +106,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度7天，endDate不能早于begingDate
+   * @return the user share
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleResult> getUserShare(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -105,6 +119,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度1天，endDate不能早于begingDate
+   * @return the user share hour
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeArticleResult> getUserShareHour(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -118,6 +134,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度7天，endDate不能早于begingDate
+   * @return the upstream msg
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsg(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -129,6 +147,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度1天，endDate不能早于begingDate
+   * @return the upstream msg hour
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgHour(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -140,6 +160,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度30天，endDate不能早于begingDate
+   * @return the upstream msg week
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgWeek(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -151,6 +173,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度30天，endDate不能早于begingDate
+   * @return the upstream msg month
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgMonth(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -162,6 +186,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度15天，endDate不能早于begingDate
+   * @return the upstream msg dist
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgDist(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -173,6 +199,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度30天，endDate不能早于begingDate
+   * @return the upstream msg dist week
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgDistWeek(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -184,6 +212,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度30天，endDate不能早于begingDate
+   * @return the upstream msg dist month
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeMsgResult> getUpstreamMsgDistMonth(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -197,6 +227,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度30天，endDate不能早于begingDate
+   * @return the interface summary
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeInterfaceResult> getInterfaceSummary(Date beginDate, Date endDate) throws WxErrorException;
 
@@ -208,6 +240,8 @@ public interface WxMpDataCubeService {
    *
    * @param beginDate 开始时间
    * @param endDate 最大时间跨度1天，endDate不能早于begingDate
+   * @return the interface summary hour
+   * @throws WxErrorException the wx error exception
    */
   List<WxDataCubeInterfaceResult> getInterfaceSummaryHour(Date beginDate, Date endDate) throws WxErrorException;
 

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/datacube/WxDataCubeArticleTotal.java

@@ -28,12 +28,17 @@ public class WxDataCubeArticleTotal extends WxDataCubeBaseResult {
   private String msgId;
 
   /**
-   * title.
    * 图文消息的标题
    */
   @SerializedName("title")
   private String title;
 
+  /**
+   * 文章地址
+   */
+  @SerializedName("url")
+  private String url;
+
   /**
    * details.
    * 详细信息
@@ -41,6 +46,14 @@ public class WxDataCubeArticleTotal extends WxDataCubeBaseResult {
   @SerializedName("details")
   private List<WxDataCubeArticleTotalDetail> details;
 
+  /**
+   * user_source
+   * 在获取图文统计数据、图文阅读分时数据时才有该字段，代表用户从哪里进入来阅读该图文。
+   * 99999999.全部；0:会话;1.好友;2.朋友圈;3.腾讯微博;4.历史消息页;5.其他;6.看一看;7.搜一搜；
+   */
+  @SerializedName("user_source")
+  private Integer userSource;
+
   public static List<WxDataCubeArticleTotal> fromJson(String json) {
     return WxMpGsonBuilder.create().fromJson(
       GsonParser.parse(json).get("list"),

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/datacube/WxDataCubeArticleTotalDetail.java

@@ -200,25 +200,25 @@ public class WxDataCubeArticleTotalDetail implements Serializable {
 
 
   /**
-   * intpagefromkanyikanreaduser 看一看来源阅读人数
+   * 看一看来源阅读人数
    */
   @SerializedName("int_page_from_kanyikan_read_user")
   private Integer intPageFromKanyikanReadUser;
 
   /**
-   * intpagefromkanyikanreadcount 看一看来源阅读次数
+   * 看一看来源阅读次数
    */
   @SerializedName("int_page_from_kanyikan_read_count")
   private Integer intPageFromKanyikanReadCount;
 
   /**
-   * intpagefromsouyisoureaduser 搜一搜来源阅读人数
+   * 搜一搜来源阅读人数
    */
   @SerializedName("int_page_from_souyisou_read_user")
   private Integer intPageFromSouyisouReadUser;
 
   /**
-   * intpagefromsouyisoureadcount 搜一搜来源阅读次数
+   *  搜一搜来源阅读次数
    */
   @SerializedName("int_page_from_souyisou_read_count")
   private Integer intPageFromSouyisouReadCount;