Add fetchAudienceForPodcast function.

Author: wenbinf

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Listen Notes
+Copyright (c) 2022 Listen Notes
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,5 +1,5 @@
 GROUP_ID=com.listennotes
-VERSION_NAME=1.1.1
+VERSION_NAME=1.1.4
 
 POM_URL=https://github.com/ListenNotes/podcast-api-java
 POM_SCM_URL[email protected]:ListenNotes/podcast-api-java.git
@@ -12,7 +12,7 @@ POM_DEVELOPER_ID=listennotes
 POM_DEVELOPER_NAME=Listen Notes, Inc.
 POM_DEVELOPER_EMAIL[email protected]
 
-POM_DESCRIPTION=The Official Java library for the Listen Notes Podcast API. Simple & no-nonsense podcast search & directory API.
+POM_DESCRIPTION=The Official Java library for the Listen Notes Podcast API. Simple & no-nonsense podcast search, directory, and insights API.
 POM_NAME=Podcast Search and Directory API
 POM_ARTIFACT_ID=podcast-api
 POM_PACKAGING=jar

gradle.properties

@@ -153,6 +153,12 @@ public ApiResponse search(Map<String, String> mapParams) throws ListenApiExcepti
         return this.get("search", mapParams);
     }
 
+    public ApiResponse fetchAudienceForPodcast(Map<String, String> mapParams) throws ListenApiException {
+        String strId = mapParams.get("id");
+        mapParams.remove("id");
+        return this.get("podcasts/" + strId + "/audience", mapParams);
+    }
+
     protected String getUrl(String strPath) {
         String strUrl = BASE_URL_TEST;
         if (this.apiKey != null &&this.apiKey.length() > 0) {

src/main/java/com/listennotes/podcast_api/Client.java

@@ -122,6 +122,11 @@ public static void main(String[] args) {
             // parameters.put("reason", "the podcaster wants to delete it");
             // response = objClient.deletePodcast( parameters );
             // System.out.println(response.toJSON().toString(2));
+
+            // parameters = new HashMap<>();
+            // parameters.put("id", "25212ac3c53240a880dd5032e547047b");
+            // response = objClient.fetchRecommendationsForPodcast( parameters );
+            // System.out.println(response.toJSON().toString(2));            
         } catch (AuthenticationException ae) {
             System.out.println("Authentication Issue: " + ae.getMessage());
         } catch (InvalidRequestException ir) {

src/main/java/com/listennotes/podcast_api/Sample.java

@@ -354,4 +354,18 @@ public void testSubmitPodcast() throws Exception {
         URL u = tester.con.getURL();
         assertEquals(u.getPath(), "/api/v2/podcasts/submit");
     }
+
+    public void testFetchAudienceForPodcast() throws Exception {
+        Client tester = new Client();
+
+        Map<String, String> parameters = new HashMap<>();
+        String id = "23";
+        parameters.put("id", id);
+        ApiResponse response = tester.fetchAudienceForPodcast(parameters);
+        JSONObject oj = response.toJSON();
+        assertTrue(oj.optJSONArray("by_regions").length() > 0);
+        assertEquals(tester.con.getRequestMethod(), "GET");
+        URL u = tester.con.getURL();
+        assertEquals(u.getPath(), "/api/v2/podcasts/" + id + "/audience");
+    }    
 }