recombee_api_client 6.0.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88fa1bd148ace9bb4ddfa4c75037c4242bf693a96e7395de3b0c23dafb325d03
-  data.tar.gz: c4bbc5474baf87cfaabc58f07b0c4e5161190473e1816e2b6f6ab61b90d32347
+  metadata.gz: 251fbc7719eb5f880e85cbc68996c563e893c0bc30b304ee75c5b34c19ac6b99
+  data.tar.gz: 753e1a9f4bf897a7e15a6ddc2127f7ca062193a1c2fce6674815167eed87ce84
 SHA512:
-  metadata.gz: ba77e029c00f29e3e4ec1d8b7790620d205e13bb4cbcc16b06061f0ce3045b74b39b815706bf0cde69d88964460a6149d8012f976e2563c9f2188464833ebc2b
-  data.tar.gz: 3a6abbe8a347b15d2fec1ec457a23870c4321839c18f75e344adaf607dcb95b2e379b20057af1d90a3edb023eb97643d2788a35088c853588cfe368e7a9a7abe
+  metadata.gz: 5a83df05802119f4c100a2f63dfd1efa216db575a6c6547fe93c0611a0a0bd509b603d9a20facb57ba829d944b750ae73d061dbce3fa14de11d5a0d2d7381d51
+  data.tar.gz: 85e6cd1960ebab74f7de00ca4dbf0da42ba001bd9d3f7685d0f43609ebef8323836b04b4cb386aff2519a46c4fd79e39abacaa1bb641704d21d315c6d30d8c89

data/lib/recombee_api_client/api/recommend_item_segments_to_item.rb

@@ -24,7 +24,7 @@ module RecombeeApiClient
   #
   class RecommendItemSegmentsToItem < ApiRequest
     attr_reader :item_id, :target_user_id, :count, :scenario, :cascade_create, :filter, :booster, :logic,
-                :expert_settings, :return_ab_group
+                :expert_settings, :return_ab_group, :reql_expressions
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -75,6 +75,43 @@ module RecombeeApiClient
     #
     #   - +returnAbGroup+ -> If there is a custom AB-testing running, return the name of the group to which the request belongs.
     #
+    #   - +reqlExpressions+ -> A dictionary of [ReQL](https://docs.recombee.com/reql) expressions that will be executed for each recommended Item Segment.
+    # This can be used to compute additional properties of the recommended Item Segments.
+    #
+    # The keys are the names of the expressions, and the values are the actual ReQL expressions.
+    #
+    # Example request:
+    # ```json
+    # {
+    #  "reqlExpressions": {
+    #    "countItems": "size(segment_items(\"categories\", 'segmentId'))"
+    #  }
+    # }
+    # ```
+    #
+    # Example response:
+    # ```json
+    # {
+    #  "recommId": "a7ac55a4-8d6e-4f19-addc-abac4164d8a8",
+    #  "recomms":
+    #    [
+    #      {
+    #        "id": "category-fantasy-books",
+    #        "reqlEvaluations": {
+    #          "countItems": 486
+    #        }
+    #      },
+    #      {
+    #        "id": "category-sci-fi-costumes",
+    #        "reqlEvaluations": {
+    #          "countItems": 19
+    #        }
+    #      }
+    #    ],
+    #   "numberNextRecommsCalls": 0
+    # }
+    # ```
+    #
     #
     def initialize(item_id, target_user_id, count, optional = {})
       @item_id = item_id
@@ -88,12 +125,13 @@ module RecombeeApiClient
       @logic = optional['logic']
       @expert_settings = optional['expertSettings']
       @return_ab_group = optional['returnAbGroup']
+      @reql_expressions = optional['reqlExpressions']
       @optional = optional
       @timeout = 3000
       @ensure_https = false
       @optional.each do |par, _|
         raise UnknownOptionalParameter.new(par) unless %w[scenario cascadeCreate filter booster logic
-                                                          expertSettings returnAbGroup].include? par
+                                                          expertSettings returnAbGroup reqlExpressions].include? par
       end
     end
 
@@ -114,6 +152,7 @@ module RecombeeApiClient
       p['logic'] = @optional['logic'] if @optional.include? 'logic'
       p['expertSettings'] = @optional['expertSettings'] if @optional.include? 'expertSettings'
       p['returnAbGroup'] = @optional['returnAbGroup'] if @optional.include? 'returnAbGroup'
+      p['reqlExpressions'] = @optional['reqlExpressions'] if @optional.include? 'reqlExpressions'
 
       p
     end

data/lib/recombee_api_client/api/recommend_item_segments_to_item_segment.rb

@@ -23,7 +23,7 @@ module RecombeeApiClient
   #
   class RecommendItemSegmentsToItemSegment < ApiRequest
     attr_reader :context_segment_id, :target_user_id, :count, :scenario, :cascade_create, :filter, :booster, :logic,
-                :expert_settings, :return_ab_group
+                :expert_settings, :return_ab_group, :reql_expressions
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -74,6 +74,43 @@ module RecombeeApiClient
     #
     #   - +returnAbGroup+ -> If there is a custom AB-testing running, return the name of the group to which the request belongs.
     #
+    #   - +reqlExpressions+ -> A dictionary of [ReQL](https://docs.recombee.com/reql) expressions that will be executed for each recommended Item Segment.
+    # This can be used to compute additional properties of the recommended Item Segments.
+    #
+    # The keys are the names of the expressions, and the values are the actual ReQL expressions.
+    #
+    # Example request:
+    # ```json
+    # {
+    #  "reqlExpressions": {
+    #    "countItems": "size(segment_items(\"categories\", 'segmentId'))"
+    #  }
+    # }
+    # ```
+    #
+    # Example response:
+    # ```json
+    # {
+    #  "recommId": "a7ac55a4-8d6e-4f19-addc-abac4164d8a8",
+    #  "recomms":
+    #    [
+    #      {
+    #        "id": "category-fantasy-books",
+    #        "reqlEvaluations": {
+    #          "countItems": 486
+    #        }
+    #      },
+    #      {
+    #        "id": "category-sci-fi-costumes",
+    #        "reqlEvaluations": {
+    #          "countItems": 19
+    #        }
+    #      }
+    #    ],
+    #   "numberNextRecommsCalls": 0
+    # }
+    # ```
+    #
     #
     def initialize(context_segment_id, target_user_id, count, optional = {})
       @context_segment_id = context_segment_id
@@ -87,12 +124,13 @@ module RecombeeApiClient
       @logic = optional['logic']
       @expert_settings = optional['expertSettings']
       @return_ab_group = optional['returnAbGroup']
+      @reql_expressions = optional['reqlExpressions']
       @optional = optional
       @timeout = 3000
       @ensure_https = false
       @optional.each do |par, _|
         raise UnknownOptionalParameter.new(par) unless %w[scenario cascadeCreate filter booster logic
-                                                          expertSettings returnAbGroup].include? par
+                                                          expertSettings returnAbGroup reqlExpressions].include? par
       end
     end
 
@@ -114,6 +152,7 @@ module RecombeeApiClient
       p['logic'] = @optional['logic'] if @optional.include? 'logic'
       p['expertSettings'] = @optional['expertSettings'] if @optional.include? 'expertSettings'
       p['returnAbGroup'] = @optional['returnAbGroup'] if @optional.include? 'returnAbGroup'
+      p['reqlExpressions'] = @optional['reqlExpressions'] if @optional.include? 'reqlExpressions'
 
       p
     end

data/lib/recombee_api_client/api/recommend_item_segments_to_user.rb

@@ -24,7 +24,7 @@ module RecombeeApiClient
   #
   class RecommendItemSegmentsToUser < ApiRequest
     attr_reader :user_id, :count, :scenario, :cascade_create, :filter, :booster, :logic, :expert_settings,
-                :return_ab_group
+                :return_ab_group, :reql_expressions
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -57,6 +57,43 @@ module RecombeeApiClient
     #
     #   - +returnAbGroup+ -> If there is a custom AB-testing running, return the name of the group to which the request belongs.
     #
+    #   - +reqlExpressions+ -> A dictionary of [ReQL](https://docs.recombee.com/reql) expressions that will be executed for each recommended Item Segment.
+    # This can be used to compute additional properties of the recommended Item Segments.
+    #
+    # The keys are the names of the expressions, and the values are the actual ReQL expressions.
+    #
+    # Example request:
+    # ```json
+    # {
+    #  "reqlExpressions": {
+    #    "countItems": "size(segment_items(\"categories\", 'segmentId'))"
+    #  }
+    # }
+    # ```
+    #
+    # Example response:
+    # ```json
+    # {
+    #  "recommId": "a7ac55a4-8d6e-4f19-addc-abac4164d8a8",
+    #  "recomms":
+    #    [
+    #      {
+    #        "id": "category-fantasy-books",
+    #        "reqlEvaluations": {
+    #          "countItems": 486
+    #        }
+    #      },
+    #      {
+    #        "id": "category-sci-fi-costumes",
+    #        "reqlEvaluations": {
+    #          "countItems": 19
+    #        }
+    #      }
+    #    ],
+    #   "numberNextRecommsCalls": 0
+    # }
+    # ```
+    #
     #
     def initialize(user_id, count, optional = {})
       @user_id = user_id
@@ -69,12 +106,13 @@ module RecombeeApiClient
       @logic = optional['logic']
       @expert_settings = optional['expertSettings']
       @return_ab_group = optional['returnAbGroup']
+      @reql_expressions = optional['reqlExpressions']
       @optional = optional
       @timeout = 3000
       @ensure_https = false
       @optional.each do |par, _|
         raise UnknownOptionalParameter.new(par) unless %w[scenario cascadeCreate filter booster logic
-                                                          expertSettings returnAbGroup].include? par
+                                                          expertSettings returnAbGroup reqlExpressions].include? par
       end
     end
 
@@ -94,6 +132,7 @@ module RecombeeApiClient
       p['logic'] = @optional['logic'] if @optional.include? 'logic'
       p['expertSettings'] = @optional['expertSettings'] if @optional.include? 'expertSettings'
       p['returnAbGroup'] = @optional['returnAbGroup'] if @optional.include? 'returnAbGroup'
+      p['reqlExpressions'] = @optional['reqlExpressions'] if @optional.include? 'reqlExpressions'
 
       p
     end

data/lib/recombee_api_client/api/search_item_segments.rb

@@ -24,7 +24,7 @@ module RecombeeApiClient
   #
   class SearchItemSegments < ApiRequest
     attr_reader :user_id, :search_query, :count, :scenario, :cascade_create, :filter, :booster, :logic,
-                :expert_settings, :return_ab_group
+                :expert_settings, :return_ab_group, :reql_expressions
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -57,6 +57,43 @@ module RecombeeApiClient
     #
     #   - +returnAbGroup+ -> If there is a custom AB-testing running, return the name of the group to which the request belongs.
     #
+    #   - +reqlExpressions+ -> A dictionary of [ReQL](https://docs.recombee.com/reql) expressions that will be executed for each recommended Item Segment.
+    # This can be used to compute additional properties of the recommended Item Segments.
+    #
+    # The keys are the names of the expressions, and the values are the actual ReQL expressions.
+    #
+    # Example request:
+    # ```json
+    # {
+    #  "reqlExpressions": {
+    #    "countItems": "size(segment_items(\"categories\", 'segmentId'))"
+    #  }
+    # }
+    # ```
+    #
+    # Example response:
+    # ```json
+    # {
+    #  "recommId": "a7ac55a4-8d6e-4f19-addc-abac4164d8a8",
+    #  "recomms":
+    #    [
+    #      {
+    #        "id": "category-fantasy-books",
+    #        "reqlEvaluations": {
+    #          "countItems": 486
+    #        }
+    #      },
+    #      {
+    #        "id": "category-sci-fi-costumes",
+    #        "reqlEvaluations": {
+    #          "countItems": 19
+    #        }
+    #      }
+    #    ],
+    #   "numberNextRecommsCalls": 0
+    # }
+    # ```
+    #
     #
     def initialize(user_id, search_query, count, optional = {})
       @user_id = user_id
@@ -70,12 +107,13 @@ module RecombeeApiClient
       @logic = optional['logic']
       @expert_settings = optional['expertSettings']
       @return_ab_group = optional['returnAbGroup']
+      @reql_expressions = optional['reqlExpressions']
       @optional = optional
       @timeout = 3000
       @ensure_https = false
       @optional.each do |par, _|
         raise UnknownOptionalParameter.new(par) unless %w[scenario cascadeCreate filter booster logic
-                                                          expertSettings returnAbGroup].include? par
+                                                          expertSettings returnAbGroup reqlExpressions].include? par
       end
     end
 
@@ -96,6 +134,7 @@ module RecombeeApiClient
       p['logic'] = @optional['logic'] if @optional.include? 'logic'
       p['expertSettings'] = @optional['expertSettings'] if @optional.include? 'expertSettings'
       p['returnAbGroup'] = @optional['returnAbGroup'] if @optional.include? 'returnAbGroup'
+      p['reqlExpressions'] = @optional['reqlExpressions'] if @optional.include? 'reqlExpressions'
 
       p
     end

data/lib/recombee_api_client/version.rb

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

data/lib/recombee_api_client.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recombee_api_client
 version: !ruby/object:Gem::Version
-  version: 6.0.0
+  version: 6.1.0
 platform: ruby
 authors:
 - Ondřej Fiedler