recombee_api_client 6.2.0 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 946801c5ff87b7b436bdebae1c869bb47adaa63d07f0a779da3da48961fdb704
-  data.tar.gz: 14e9ead529eb19b683314182f8cdf2c22f18f208f4d58559a6aa8086e788343f
+  metadata.gz: 322e3294002769557374b46669a1958f70b82f0d0934d0c3591fe2171d6f4339
+  data.tar.gz: 454a96ba684ea9cfd9ccfe054dc11a3882c44ea223d791443ebfec60942283d6
 SHA512:
-  metadata.gz: 41cf5de6569aae7b973a3d03eccd2d819aaadcce8c2afccba7d8b38462c822bb04efbbe033fa96a4ad7d89a7a9891d947c6fe8779fe9732ae2cd59ae1584acae
-  data.tar.gz: f8ef99a8dffd542ea917e43a2ae776eeda38308daa9dc12f62155623df2ff633793aa5d5a054c10d48f0065d9633dbe1e382f07fd3fc73d22636e9635b825ebb
+  metadata.gz: b81694d2b9129008f36176f97549987cc0b6e70e1483c7255f1a96e93212bd031a39e195affa1a983981a5ebb75bd39a7681769f285e59d718cdc46119c4544d
+  data.tar.gz: bab1496561a47afc49bf0395848d31a903bf6e6bcaee3c438c5c04957b3833a6b59e67886414f49a7a4b077dd2e4dbfdc1951b443867bf639cc2c5ec308bc0cb

data/lib/recombee_api_client/api/add_item_property.rb

@@ -10,7 +10,7 @@ module RecombeeApiClient
   # Adding an item property is somewhat equivalent to adding a column to the table of items. The items may be characterized by various properties of different types.
   #
   class AddItemProperty < ApiRequest
-    attr_reader :property_name, :type
+    attr_reader :property_name, :type, :role, :metadata
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -19,7 +19,7 @@ module RecombeeApiClient
     #
     #   - +type+ -> Value type of the item property to be created. One of: `int`, `double`, `string`, `boolean`, `timestamp`, `set`, `image` or `imageList`.
     #
-    # * `int`- Signed integer number.
+    # * `int` - Signed integer number.
     #
     # * `double` - Floating point number. It uses 64-bit base-2 format (IEEE 754 standard).
     #
@@ -27,7 +27,7 @@ module RecombeeApiClient
     #
     # * `boolean` - *true* / *false*
     #
-    # * `timestamp` - Value representing date and time.
+    # * `timestamp` - Value representing date and time. ISO8601-1 pattern (string) or UTC epoch time (number).
     #
     # * `set` - Set of strings.
     #
@@ -36,11 +36,23 @@ module RecombeeApiClient
     # * `imageList` - List of URLs that refer to images.
     #
     #
-    def initialize(property_name, type)
+    # * *Optional arguments (given as hash optional)*
+    #   - +role+ -> [Role](https://docs.recombee.com/api/property_roles_metadata#roles) to assign to the property.
+    #
+    #   - +metadata+ -> List of [metadata](https://docs.recombee.com/api/property_roles_metadata#metadata) entries to assign to the property.
+    #
+    def initialize(property_name, type, optional = {})
       @property_name = property_name
       @type = type
+      optional = normalize_hash_to_camel_case(optional)
+      @role = optional['role']
+      @metadata = optional['metadata']
+      @optional = optional
       @timeout = 100_000
       @ensure_https = false
+      @optional.each do |par, _|
+        raise UnknownOptionalParameter.new(par) unless %w[role metadata].include? par
+      end
     end
 
     # HTTP method
@@ -50,16 +62,18 @@ module RecombeeApiClient
 
     # Values of body parameters as a Hash
     def body_parameters
-      {}
+      p = {}
+      p['type'] = @type
+      p['role'] = @optional['role'] if @optional.include? 'role'
+      p['metadata'] = @optional['metadata'] if @optional.include? 'metadata'
+
+      p
     end
 
     # Values of query parameters as a Hash.
     # name of parameter => value of the parameter
     def query_parameters
-      params = {}
-      params['type'] = @type
-
-      params
+      {}
     end
 
     # Relative path to the endpoint

data/lib/recombee_api_client/api/add_user_property.rb

@@ -10,7 +10,7 @@ module RecombeeApiClient
   # Adding a user property is somewhat equivalent to adding a column to the table of users. The users may be characterized by various properties of different types.
   #
   class AddUserProperty < ApiRequest
-    attr_reader :property_name, :type
+    attr_reader :property_name, :type, :role, :metadata
     attr_accessor :timeout, :ensure_https
 
     ##
@@ -27,16 +27,28 @@ module RecombeeApiClient
     #
     # * `boolean` - *true* / *false*
     #
-    # * `timestamp` - Value representing date and time.
+    # * `timestamp` - Value representing date and time. ISO8601-1 pattern (string) or UTC epoch time (number).
     #
     # * `set` - Set of strings.
     #
     #
-    def initialize(property_name, type)
+    # * *Optional arguments (given as hash optional)*
+    #   - +role+ -> [Role](https://docs.recombee.com/api/property_roles_metadata#roles) to assign to the property.
+    #
+    #   - +metadata+ -> List of [metadata](https://docs.recombee.com/api/property_roles_metadata#metadata) entries to assign to the property.
+    #
+    def initialize(property_name, type, optional = {})
       @property_name = property_name
       @type = type
+      optional = normalize_hash_to_camel_case(optional)
+      @role = optional['role']
+      @metadata = optional['metadata']
+      @optional = optional
       @timeout = 100_000
       @ensure_https = false
+      @optional.each do |par, _|
+        raise UnknownOptionalParameter.new(par) unless %w[role metadata].include? par
+      end
     end
 
     # HTTP method
@@ -46,16 +58,18 @@ module RecombeeApiClient
 
     # Values of body parameters as a Hash
     def body_parameters
-      {}
+      p = {}
+      p['type'] = @type
+      p['role'] = @optional['role'] if @optional.include? 'role'
+      p['metadata'] = @optional['metadata'] if @optional.include? 'metadata'
+
+      p
     end
 
     # Values of query parameters as a Hash.
     # name of parameter => value of the parameter
     def query_parameters
-      params = {}
-      params['type'] = @type
-
-      params
+      {}
     end
 
     # Relative path to the endpoint

data/lib/recombee_api_client/api/recommend_next_item_segments.rb

@@ -7,23 +7,24 @@ module RecombeeApiClient
   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.
+  # Returns [Item Segments](https://docs.recombee.com/segmentations) to be shown as the next recommendations when a user scrolls (e.g., within a carousel or feed of Item Segments such as brands, artists, topics, or categories).
+  #
+  # The request requires the `recommId` of a base recommendation request and the number of Segments to return (`count`).
   #
-  # 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.
+  # All other parameters are inherited from the base request associated with the provided `recommId`.
   #
-  # *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.
+  # This endpoint can be called multiple times for a single `recommId`. Each call returns different Item Segments that have not been recommended in previous calls.
+  # The number of calls made 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.
+  # Requests can be made up to 30 minutes after the base request or the most recent Recommend Next Item Segments call.
   #
-  # For billing purposes, each call to *Recommend next Item segments* is counted as a separate recommendation request.
+  # For billing purposes, each call to this endpoint is counted as a separate recommendation request.
   #
   class RecommendNextItemSegments < ApiRequest
     attr_reader :recomm_id, :count

data/lib/recombee_api_client/inputs/property_metadata.rb

@@ -0,0 +1,46 @@
+#
+# This file is auto-generated, do not edit
+#
+
+require 'json'
+
+module RecombeeApiClient
+  require_relative 'input'
+  require_relative '../errors'
+
+  ##
+  # Initializes PropertyMetadata input#
+  class PropertyMetadata < Input
+    attr_reader :name, :settings
+
+    ##
+    # * *Required arguments*
+    #   - +name+ -> Name of the [metadata](https://docs.recombee.com/api/property_roles_metadata#metadata) assigned to the property.
+    #
+    # * *Optional arguments (given as hash optional)*
+    #   - +settings+ -> Optional configuration for this metadata entry.
+    #
+    def initialize(name, optional = {})
+      @name = name
+      optional = normalize_hash_to_camel_case(optional)
+      @settings = optional['settings']
+      @optional = optional
+      @optional.each do |par, _|
+        raise UnknownOptionalParameter.new(par) unless ['settings'].include? par
+      end
+    end
+
+    # Return only JSON-serializable primitives.
+    def as_json(_options = {})
+      res = {}
+      res['name'] = @name
+      res['settings'] = @optional['settings'] if @optional['settings']
+
+      res
+    end
+
+    def to_json(*args)
+      as_json.to_json(*args)
+    end
+  end
+end

data/lib/recombee_api_client/inputs/property_role.rb

@@ -0,0 +1,46 @@
+#
+# This file is auto-generated, do not edit
+#
+
+require 'json'
+
+module RecombeeApiClient
+  require_relative 'input'
+  require_relative '../errors'
+
+  ##
+  # Initializes PropertyRole input#
+  class PropertyRole < Input
+    attr_reader :name, :settings
+
+    ##
+    # * *Required arguments*
+    #   - +name+ -> Name of the [role](https://docs.recombee.com/api/property_roles_metadata#roles) assigned to the property.
+    #
+    # * *Optional arguments (given as hash optional)*
+    #   - +settings+ -> Optional configuration specific to the selected role.
+    #
+    def initialize(name, optional = {})
+      @name = name
+      optional = normalize_hash_to_camel_case(optional)
+      @settings = optional['settings']
+      @optional = optional
+      @optional.each do |par, _|
+        raise UnknownOptionalParameter.new(par) unless ['settings'].include? par
+      end
+    end
+
+    # Return only JSON-serializable primitives.
+    def as_json(_options = {})
+      res = {}
+      res['name'] = @name
+      res['settings'] = @optional['settings'] if @optional['settings']
+
+      res
+    end
+
+    def to_json(*args)
+      as_json.to_json(*args)
+    end
+  end
+end

data/lib/recombee_api_client/version.rb

@@ -1,3 +1,3 @@
 module RecombeeApiClient
-  VERSION = '6.2.0'
+  VERSION = '6.3.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.2.0' }
+    USER_AGENT = { 'User-Agent' => 'recombee-ruby-api-client/6.3.0' }
 
     ##
     #   - +account+ -> Name of your account at Recombee

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: recombee_api_client
 version: !ruby/object:Gem::Version
-  version: 6.2.0
+  version: 6.3.0
 platform: ruby
 authors:
 - Ondřej Fiedler
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -181,6 +181,8 @@ files:
 - lib/recombee_api_client/inputs/composite_recommendation_stage_parameters.rb
 - lib/recombee_api_client/inputs/input.rb
 - lib/recombee_api_client/inputs/logic.rb
+- lib/recombee_api_client/inputs/property_metadata.rb
+- lib/recombee_api_client/inputs/property_role.rb
 - lib/recombee_api_client/utils/hash_normalizer.rb
 - lib/recombee_api_client/version.rb
 - recombee_api_client.gemspec
@@ -202,7 +204,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Client for Recombee recommendation API
 test_files: []