add new analytics API endpoints with documentation

Author: Tobias Hauth

swiftype/swiftype.py

@@ -103,6 +103,14 @@ def analytics_autoselects(self, engine_id, start_date=None, end_date=None):
   def analytics_top_queries(self, engine_id, page=None, per_page=None):
     return self.conn._get(self.__analytics_path(engine_id) + '/top_queries', self.__pagination_params(page, per_page))
 
+  def analytics_top_queries_in_range(self, engine_id, start_date=None, end_date=None):
+    params = dict((k,v) for k,v in {'start_date': start_date, 'end_date': end_date}.iteritems() if v is not None)
+    return self.conn._get(self.__analytics_path(engine_id) + '/top_queries_in_range', params)
+
+  def analytics_top_no_result_queries(self, engine_id, start_date=None, end_date=None):
+    params = dict((k,v) for k,v in {'start_date': start_date, 'end_date': end_date}.iteritems() if v is not None)
+    return self.conn._get(self.__analytics_path(engine_id) + '/top_no_result_queries_in_range', params)
+
   def domains(self, engine_id):
     return self.conn._get(self.__domains_path(engine_id))
 

swiftype/test_swiftype.py

@@ -153,6 +153,18 @@ def test_analytics_top_queries_pagination(self):
         top_queries = self.client.analytics_top_queries(self.engine, 2, 10)['body']
         self.assertTrue(len(top_queries) == 0)
 
+    def test_analytics_top_queries_in_range(self):
+        top_queries = self.client.analytics_top_queries_in_range(self.engine, '2013-01-01', '2013-02-01')['body']
+        self.assertTrue(len(top_queries) == 1)
+
+    def test_analytics_top_no_result_queries(self):
+        autoselects = self.client.analytics_top_no_result_queries(self.engine)['body']
+        self.assertTrue(len(autoselects) == 2)
+
+    def test_analytics_top_no_result_queries_with_dates(self):
+        autoselects = self.client.analytics_top_no_result_queries(self.engine, '2013-01-01', '2013-02-01')['body']
+        self.assertTrue(len(autoselects) == 0)
+
     def test_domains(self):
         domains = self.client.domains(self.engine)['body']
         self.assertTrue(len(domains) == 2)