Release: v6.2.0

- Added recommend-next-item-segments endpoint support
- Added `searchQuery` parameter support for composite recommendations

Author: MichalDemko

lib/recombee_api_client.rb

@@ -19,7 +19,7 @@ class RecombeeClient
     include HTTParty
 
     BATCH_MAX_SIZE = 10_000
-    USER_AGENT = { 'User-Agent' => 'recombee-ruby-api-client/6.1.0' }
+    USER_AGENT = { 'User-Agent' => 'recombee-ruby-api-client/6.2.0' }
 
     ##
     #   - +account+ -> Name of your account at Recombee

lib/recombee_api_client/api/composite_recommendation.rb

@@ -7,7 +7,7 @@ module RecombeeApiClient
   require_relative '../errors'
 
   ##
-  # Composite Recommendation returns both a *source entity* (e.g., an Item or [Item Segment](https://docs.recombee.com/segmentations.html)) and a list of related recommendations in a single response.
+  # Composite Recommendation returns both a *source entity* (e.g., an Item or [Item Segment](https://docs.recombee.com/segmentations)) and a list of related recommendations in a single response.
   #
   # It is ideal for use cases such as personalized homepage sections (*Articles from <category>*), *Because You Watched <movie>*, or *Artists Related to Your Favorite Artist <artist>*.
   #
@@ -37,8 +37,8 @@ module RecombeeApiClient
   # See [this example](https://docs.recombee.com/api#composite-recommendation-example-setting-parameters-for-individual-stages) for more details.
   #
   class CompositeRecommendation < ApiRequest
-    attr_reader :scenario, :count, :item_id, :user_id, :logic, :segment_id, :cascade_create, :source_settings,
-                :result_settings, :expert_settings
+    attr_reader :scenario, :count, :item_id, :user_id, :logic, :segment_id, :search_query, :cascade_create,
+                :source_settings, :result_settings, :expert_settings
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -66,6 +66,8 @@ class CompositeRecommendation < ApiRequest
     #
     #   - +segmentId+ -> ID of the segment from `contextSegmentationId` for which the recommendations are to be generated.
     #
+    #   - +searchQuery+ -> Search query provided by the user. It is used for the full-text search. Only applicable if the *scenario* corresponds to a search scenario.
+    #
     #   - +cascadeCreate+ -> If the entity for the source recommendation does not exist in the database, returns a list of non-personalized recommendations and creates the user in the database. This allows, for example, rotations in the following recommendations for that entity, as the entity will be already known to the system.
     #
     #   - +sourceSettings+ -> Parameters applied for recommending the *Source* stage. The accepted parameters correspond with the recommendation sub-endpoint used to recommend the *Source*.
@@ -83,6 +85,7 @@ def initialize(scenario, count, optional = {})
       @user_id = optional['userId']
       @logic = optional['logic']
       @segment_id = optional['segmentId']
+      @search_query = optional['searchQuery']
       @cascade_create = optional['cascadeCreate']
       @source_settings = optional['sourceSettings']
       @result_settings = optional['resultSettings']
@@ -91,8 +94,8 @@ def initialize(scenario, count, optional = {})
       @timeout = 3000
       @ensure_https = false
       @optional.each do |par, _|
-        raise UnknownOptionalParameter.new(par) unless %w[itemId userId logic segmentId cascadeCreate
-                                                          sourceSettings resultSettings expertSettings].include? par
+        raise UnknownOptionalParameter.new(par) unless %w[itemId userId logic segmentId searchQuery
+                                                          cascadeCreate sourceSettings resultSettings expertSettings].include? par
       end
     end
 
@@ -110,6 +113,7 @@ def body_parameters
       p['userId'] = @optional['userId'] if @optional.include? 'userId'
       p['logic'] = @optional['logic'] if @optional.include? 'logic'
       p['segmentId'] = @optional['segmentId'] if @optional.include? 'segmentId'
+      p['searchQuery'] = @optional['searchQuery'] if @optional.include? 'searchQuery'
       p['cascadeCreate'] = @optional['cascadeCreate'] if @optional.include? 'cascadeCreate'
       p['sourceSettings'] = @optional['sourceSettings'] if @optional.include? 'sourceSettings'
       p['resultSettings'] = @optional['resultSettings'] if @optional.include? 'resultSettings'

lib/recombee_api_client/api/recommend_next_item_segments.rb

@@ -0,0 +1,69 @@
+#
+# This file is auto-generated, do not edit
+#
+
+module RecombeeApiClient
+  require_relative 'request'
+  require_relative '../errors'
+
+  ##
+  # Returns Item segments that shall be shown to a user as next recommendations when the user e.g. scrolls the page down (*infinite scroll*) or goes to the next page.
+  #
+  # It accepts `recommId` of a base recommendation request (e.g., request from the first page) and the number of segments that shall be returned (`count`).
+  # The base request can be one of:
+  #  - [Recommend Item Segments to Item](https://docs.recombee.com/api#recommend-item-segments-to-item)
+  #  - [Recommend Item Segments to User](https://docs.recombee.com/api#recommend-item-segments-to-user)
+  #  - [Recommend Item Segments to Item Segment](https://docs.recombee.com/api#recommend-item-segments-to-item-segment)
+  #  - [Search Item Segments](https://docs.recombee.com/api#search-item-segments)
+  #
+  # All the other parameters are inherited from the base request.
+  #
+  # *Recommend next Item segments* can be called many times for a single `recommId` and each call returns different (previously not recommended) segments.
+  # The number of *Recommend next Item segments* calls performed so far is returned in the `numberNextRecommsCalls` field.
+  #
+  # *Recommend next Item segments* can be requested up to 30 minutes after the base request or a previous *Recommend next Item segments* call.
+  #
+  # For billing purposes, each call to *Recommend next Item segments* is counted as a separate recommendation request.
+  #
+  class RecommendNextItemSegments < ApiRequest
+    attr_reader :recomm_id, :count
+    attr_accessor :timeout, :ensure_https
+
+    ##
+    # * *Required arguments*
+    #   - +recomm_id+ -> ID of the base recommendation request for which next recommendations should be returned
+    #   - +count+ -> Number of item segments to be recommended
+    #
+    #
+    def initialize(recomm_id, count)
+      @recomm_id = recomm_id
+      @count = count
+      @timeout = 3000
+      @ensure_https = false
+    end
+
+    # HTTP method
+    def method
+      :post
+    end
+
+    # Values of body parameters as a Hash
+    def body_parameters
+      p = {}
+      p['count'] = @count
+
+      p
+    end
+
+    # Values of query parameters as a Hash.
+    # name of parameter => value of the parameter
+    def query_parameters
+      {}
+    end
+
+    # Relative path to the endpoint
+    def path
+      "/{databaseId}/recomms/next/item-segments/#{@recomm_id}"
+    end
+  end
+end

lib/recombee_api_client/version.rb

@@ -1,3 +1,3 @@
 module RecombeeApiClient
-  VERSION = '6.1.0'
+  VERSION = '6.2.0'
 end

spec/api/next_item_segments_recommendation.rb

@@ -0,0 +1,27 @@
+#
+# This file is auto-generated, do not edit
+#
+
+require 'spec_helper'
+require_relative 'set_environment'
+shared_examples 'next item segments recommendation' do
+  include_context 'set environment'
+
+  it 'rejects request with invalid recommId' do
+    req = RecommendNextItemSegments.new('invalid_recomm_id', 5)
+    expect { @client.send(req) }.to(raise_exception do |exception|
+      expect(exception).to be_a(RecombeeApiClient::ResponseError)
+      expect(exception.status_code).to eq 400
+    end)
+  end
+
+  it 'rejects request to recommId which does not return item-segments' do
+    req = RecommendItemsToUser.new('entity_id', 3)
+    resp = @client.send(req)
+    req = described_class.new(resp['recommId'], 5)
+    expect { @client.send(req) }.to(raise_exception do |exception|
+      expect(exception).to be_a(RecombeeApiClient::ResponseError)
+      expect(exception.status_code).to eq 400
+    end)
+  end
+end

spec/api/recommend_next_item_segments_spec.rb

@@ -0,0 +1,10 @@
+#
+# This file is auto-generated, do not edit
+#
+
+require 'spec_helper'
+require_relative 'next_item_segments_recommendation'
+
+describe RecombeeApiClient::RecommendNextItemSegments do
+  it_behaves_like 'next item segments recommendation'
+end