Release: v6.0.0

- Added support for the new Composite Recommendation endpoint
- Added new parameter `autoPresented` for Detail View and View Portion interactions
- Added new parameter `timeSpent` for View Portion interactions
- Added support for `reqlExpressions` on recommended items
- The `name` parameter of the Logic input is no longer mandatory

Author: OndraFiedler

README.md

@@ -13,7 +13,7 @@ The client is available in the [Maven Central Repository](https://mvnrepository.
     <dependency>
         <groupId>com.recombee</groupId>
         <artifactId>api-client</artifactId>
-        <version>5.1.2</version>
+        <version>6.0.0</version>
     </dependency>
 ```
 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>com.recombee</groupId>
     <artifactId>api-client</artifactId>
-    <version>5.1.2</version>
+    <version>6.0.0</version>
     <name>Recombee API Client</name>
     <description>A client library for easy use of the Recombee recommendation API</description>
     <url>https://www.recombee.com</url>

src/main/java/com/recombee/api_client/RecombeeClient.java

@@ -74,6 +74,7 @@
 import com.recombee.api_client.api_requests.RecommendItemSegmentsToUser;
 import com.recombee.api_client.api_requests.RecommendItemSegmentsToItem;
 import com.recombee.api_client.api_requests.RecommendItemSegmentsToItemSegment;
+import com.recombee.api_client.api_requests.CompositeRecommendation;
 import com.recombee.api_client.api_requests.SearchItems;
 import com.recombee.api_client.api_requests.SearchItemSegments;
 import com.recombee.api_client.api_requests.AddSearchSynonym;
@@ -97,7 +98,7 @@ public class RecombeeClient {
 
     final int BATCH_MAX_SIZE = 10000; //Maximal number of requests within one batch request
 
-    final String USER_AGENT = "recombee-java-api-client/5.1.2";
+    final String USER_AGENT = "recombee-java-api-client/6.0.0";
 
     private final OkHttpClient httpClient = new OkHttpClient();
 
@@ -443,6 +444,16 @@ public RecommendationResponse send(RecommendItemSegmentsToItemSegment request) t
          return null;
     }
 
+    public CompositeRecommendationResponse send(CompositeRecommendation request) throws ApiException {
+        String responseStr = sendRequest(request);
+        try {
+            return this.mapper.readValue(responseStr, CompositeRecommendationResponse.class);
+        } catch (IOException e) {
+            e.printStackTrace();
+         }
+         return null;
+    }
+
     public SearchResponse send(SearchItems request) throws ApiException {
         String responseStr = sendRequest(request);
         try {
@@ -754,6 +765,12 @@ else if (request instanceof ListUserViewPortions)
                         parsedResponse = ar;
                     }
 
+                    else if (request instanceof CompositeRecommendation)
+                    {
+                        Map<String, Object> obj = (Map<String, Object>) parsedResponse;
+                        parsedResponse = new CompositeRecommendationResponse(obj);
+                    }
+
                     else if (request instanceof GetSegmentation)
                     {
                         Map<String, Object> obj = (Map<String, Object>) parsedResponse;

src/main/java/com/recombee/api_client/api_requests/AddBookmark.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**

src/main/java/com/recombee/api_client/api_requests/AddCartAddition.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**

src/main/java/com/recombee/api_client/api_requests/AddDetailView.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**
@@ -44,6 +45,10 @@ public class AddDetailView extends Request {
      * A dictionary of additional data for the interaction.
      */
     protected Map<String, Object> additionalData;
+    /**
+     * Indicates whether the item was automatically presented to the user (e.g., in a swiping feed) or explicitly requested by the user (e.g., by clicking on a link). Defaults to `false`.
+     */
+    protected Boolean autoPresented;
 
     /**
      * Construct the request
@@ -96,6 +101,14 @@ public AddDetailView setAdditionalData(Map<String, Object> additionalData) {
          return this;
     }
 
+    /**
+     * @param autoPresented Indicates whether the item was automatically presented to the user (e.g., in a swiping feed) or explicitly requested by the user (e.g., by clicking on a link). Defaults to `false`.
+     */
+    public AddDetailView setAutoPresented(boolean autoPresented) {
+         this.autoPresented = autoPresented;
+         return this;
+    }
+
     public String getUserId() {
          return this.userId;
     }
@@ -125,6 +138,11 @@ public Map<String, Object> getAdditionalData() {
          return this.additionalData;
     }
 
+    public boolean getAutoPresented() {
+         if (this.autoPresented==null) return false;
+         return this.autoPresented;
+    }
+
     /**
      * @return Used HTTP method
      */
@@ -175,6 +193,9 @@ public Map<String, Object> getBodyParameters() {
         if (this.additionalData!=null) {
             params.put("additionalData", this.additionalData);
         }
+        if (this.autoPresented!=null) {
+            params.put("autoPresented", this.autoPresented);
+        }
         return params;
     }
 

src/main/java/com/recombee/api_client/api_requests/AddItem.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**

src/main/java/com/recombee/api_client/api_requests/AddItemProperty.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**

src/main/java/com/recombee/api_client/api_requests/AddManualReqlSegment.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**

src/main/java/com/recombee/api_client/api_requests/AddPurchase.java

@@ -9,6 +9,7 @@
 import java.util.HashMap;
 
 import com.recombee.api_client.bindings.Logic;
+import com.recombee.api_client.bindings.CompositeRecommendationStageParameters;
 import com.recombee.api_client.util.HTTPMethod;
 
 /**