trophy_api_client 1.0.30 → 1.0.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c25a821fcf1f05012a279bf8ad031328a32bf4e485600e4b6f1db1484de8daa8
-  data.tar.gz: b2b975f8d431ec31f8ddec8bb2f73803dee6a45ebcbb4b92103ea904b7f5ae6b
+  metadata.gz: ae06f4ad10f6292d25008af408ba0947190adfdda8bf9a243333e21b3d1b2bd8
+  data.tar.gz: c54d6136018d217c6236c43f9683d362903060538d5429e5a35266d2a7e0983c
 SHA512:
-  metadata.gz: 33c5da328d9511d8a1f0231d1697ebf671b9463b426fcf575a9be4037f5963f5a23347e358e38ef12a05fbc9da9a6c27f2ad36b134a07d07887605ae8d44c86a
-  data.tar.gz: 01dbb928522b7d992d4788e3112f058455a143f870215824a2c1336cb165ace1bb5a5469ec4cbfade09c31cc49987931119156b05efb1ad2c9ebeb8b97339a0a
+  metadata.gz: 255581f34cedb5460cbed75b5c8a946150f5e2c768c445fd01a532d0f4dc3986d3bf0318eb2580a1126229e1a88c0f1a53291708011e57623700c2aee1cf28dd
+  data.tar.gz: eedad3138a96ca0f72d3e661c03db489db53cde53cc9a8dc652600db1c9964ebdab6553daf089b791c54183d40bcf4db255db38d26f4819fdd67555dea592c28

data/lib/gemconfig.rb

@@ -2,7 +2,7 @@
 
 module TrophyApiClient
   module Gemconfig
-    VERSION = "1.0.30"
+    VERSION = "1.0.31"
     AUTHORS = ["Trophy Labs, Inc"].freeze
     EMAIL = ""
     SUMMARY = "Ruby library for the Trophy API."

data/lib/trophy_api_client/achievements/client.rb

@@ -20,6 +20,9 @@ module TrophyApiClient
 
     # Get all achievements and their completion stats.
     #
+    # @param user_attributes [String] Optional colon-delimited user attributes in the format
+    #  attribute:value,attribute:value. Only achievements accessible to a user with the
+    #  provided attributes will be returned.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [Array<TrophyApiClient::AchievementWithStatsResponse>]
     # @example
@@ -28,8 +31,8 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.all
-    def all(request_options: nil)
+    #  api.achievements.all(user_attributes: "plan-type:premium,region:us-east")
+    def all(user_attributes: nil, request_options: nil)
       response = @request_client.conn.get do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
@@ -38,9 +41,10 @@ module TrophyApiClient
       **@request_client.get_headers,
       **(request_options&.additional_headers || {})
         }.compact
-        unless request_options.nil? || request_options&.additional_query_parameters.nil?
-          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-        end
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "userAttributes": user_attributes
+        }.compact
         unless request_options.nil? || request_options&.additional_body_parameters.nil?
           req.body = { **(request_options&.additional_body_parameters || {}) }.compact
         end
@@ -105,6 +109,9 @@ module TrophyApiClient
 
     # Get all achievements and their completion stats.
     #
+    # @param user_attributes [String] Optional colon-delimited user attributes in the format
+    #  attribute:value,attribute:value. Only achievements accessible to a user with the
+    #  provided attributes will be returned.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [Array<TrophyApiClient::AchievementWithStatsResponse>]
     # @example
@@ -113,8 +120,8 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.all
-    def all(request_options: nil)
+    #  api.achievements.all(user_attributes: "plan-type:premium,region:us-east")
+    def all(user_attributes: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -124,9 +131,10 @@ module TrophyApiClient
         **@request_client.get_headers,
         **(request_options&.additional_headers || {})
           }.compact
-          unless request_options.nil? || request_options&.additional_query_parameters.nil?
-            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-          end
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "userAttributes": user_attributes
+          }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact
           end

data/lib/trophy_api_client/leaderboards/client.rb

@@ -61,6 +61,9 @@ module TrophyApiClient
     #  run.
     # @param user_id [String] When provided, offset is relative to this user's position on the leaderboard. If
     #  the user is not found in the leaderboard, returns empty rankings array.
+    # @param user_attributes [String] Attribute key and value to filter the rankings by, separated by a colon. This
+    #  parameter is required, and only valid for leaderboards with a breakdown
+    #  attribute.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
     # @example
@@ -74,9 +77,10 @@ module TrophyApiClient
     #    offset: 1,
     #    limit: 1,
     #    run: "2025-01-15",
-    #    user_id: "user-123"
+    #    user_id: "user-123",
+    #    user_attributes: "city:London"
     #  )
-    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, request_options: nil)
+    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, user_attributes: nil, request_options: nil)
       response = @request_client.conn.get do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
@@ -90,7 +94,8 @@ module TrophyApiClient
           "offset": offset,
           "limit": limit,
           "run": run,
-          "userId": user_id
+          "userId": user_id,
+          "userAttributes": user_attributes
         }.compact
         unless request_options.nil? || request_options&.additional_body_parameters.nil?
           req.body = { **(request_options&.additional_body_parameters || {}) }.compact
@@ -157,6 +162,9 @@ module TrophyApiClient
     #  run.
     # @param user_id [String] When provided, offset is relative to this user's position on the leaderboard. If
     #  the user is not found in the leaderboard, returns empty rankings array.
+    # @param user_attributes [String] Attribute key and value to filter the rankings by, separated by a colon. This
+    #  parameter is required, and only valid for leaderboards with a breakdown
+    #  attribute.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
     # @example
@@ -170,9 +178,10 @@ module TrophyApiClient
     #    offset: 1,
     #    limit: 1,
     #    run: "2025-01-15",
-    #    user_id: "user-123"
+    #    user_id: "user-123",
+    #    user_attributes: "city:London"
     #  )
-    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, request_options: nil)
+    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, user_attributes: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -187,7 +196,8 @@ module TrophyApiClient
             "offset": offset,
             "limit": limit,
             "run": run,
-            "userId": user_id
+            "userId": user_id,
+            "userAttributes": user_attributes
           }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact

data/lib/trophy_api_client/leaderboards/types/leaderboards_all_response_item.rb

@@ -19,6 +19,8 @@ module TrophyApiClient
       attr_reader :key
       # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
       attr_reader :rank_by
+      # @return [String] The key of the attribute to break down this leaderboard by.
+      attr_reader :breakdown_attribute
       # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
       attr_reader :metric_key
       # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -55,6 +57,7 @@ module TrophyApiClient
       # @param name [String] The user-facing name of the leaderboard.
       # @param key [String] The unique key used to reference the leaderboard in APIs.
       # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+      # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
       # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
       # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
       # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -70,13 +73,14 @@ module TrophyApiClient
       #  type.
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [TrophyApiClient::Leaderboards::LeaderboardsAllResponseItem]
-      def initialize(status:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT,
-                     points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+      def initialize(status:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT,
+                     metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
         @status = status
         @id = id
         @name = name
         @key = key
         @rank_by = rank_by
+        @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
         @metric_key = metric_key if metric_key != OMIT
         @metric_name = metric_name if metric_name != OMIT
         @points_system_key = points_system_key if points_system_key != OMIT
@@ -94,6 +98,7 @@ module TrophyApiClient
           "name": name,
           "key": key,
           "rankBy": rank_by,
+          "breakdownAttribute": breakdown_attribute,
           "metricKey": metric_key,
           "metricName": metric_name,
           "pointsSystemKey": points_system_key,
@@ -121,6 +126,7 @@ module TrophyApiClient
         name = parsed_json["name"]
         key = parsed_json["key"]
         rank_by = parsed_json["rankBy"]
+        breakdown_attribute = parsed_json["breakdownAttribute"]
         metric_key = parsed_json["metricKey"]
         metric_name = parsed_json["metricName"]
         points_system_key = parsed_json["pointsSystemKey"]
@@ -137,6 +143,7 @@ module TrophyApiClient
           name: name,
           key: key,
           rank_by: rank_by,
+          breakdown_attribute: breakdown_attribute,
           metric_key: metric_key,
           metric_name: metric_name,
           points_system_key: points_system_key,
@@ -170,6 +177,7 @@ module TrophyApiClient
         obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
         obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
         obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+        obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
         obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
         obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
         obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/points/client.rb

@@ -21,8 +21,8 @@ module TrophyApiClient
     #
     # @param key [String] Key of the points system.
     # @param user_attributes [String] Optional colon-delimited user attribute filters in the format
-    #  attributeKey:value,attributeKey:value. Only users matching ALL specified
-    #  attributes will be included in the points breakdown.
+    #  attribute:value,attribute:value. Only users matching ALL specified attributes
+    #  will be included in the points breakdown.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::POINTS_SUMMARY_RESPONSE]
     # @example
@@ -104,8 +104,8 @@ module TrophyApiClient
     #
     # @param key [String] Key of the points system.
     # @param user_attributes [String] Optional colon-delimited user attribute filters in the format
-    #  attributeKey:value,attributeKey:value. Only users matching ALL specified
-    #  attributes will be included in the points breakdown.
+    #  attribute:value,attribute:value. Only users matching ALL specified attributes
+    #  will be included in the points breakdown.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::POINTS_SUMMARY_RESPONSE]
     # @example

data/lib/trophy_api_client/types/leaderboard_response.rb

@@ -16,6 +16,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -51,6 +53,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -66,12 +69,13 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::LeaderboardResponse]
-    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT,
-                   points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT,
+                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -88,6 +92,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -114,6 +119,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -129,6 +135,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -161,6 +168,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/leaderboard_response_with_rankings.rb

@@ -21,6 +21,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -58,6 +60,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -73,14 +76,15 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
-    def initialize(status:, rankings:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(status:, rankings:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT,
+                   metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @status = status
       @rankings = rankings
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -99,6 +103,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -130,6 +135,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -147,6 +153,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -181,6 +188,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/metric_event_leaderboard_response.rb

@@ -19,6 +19,9 @@ module TrophyApiClient
     # @return [Integer] The minimum value required to enter the leaderboard according to its current
     #  rankings.
     attr_reader :threshold
+    # @return [String] For leaderboards with a breakdown attribute, the value of the attribute for the
+    #  user.
+    attr_reader :breakdown_attribute_value
     # @return [String] The unique ID of the leaderboard.
     attr_reader :id
     # @return [String] The user-facing name of the leaderboard.
@@ -27,6 +30,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -63,10 +68,13 @@ module TrophyApiClient
     #  on the leaderboard before the event.
     # @param threshold [Integer] The minimum value required to enter the leaderboard according to its current
     #  rankings.
+    # @param breakdown_attribute_value [String] For leaderboards with a breakdown attribute, the value of the attribute for the
+    #  user.
     # @param id [String] The unique ID of the leaderboard.
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -80,16 +88,18 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::MetricEventLeaderboardResponse]
-    def initialize(threshold:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, end_: OMIT, rank: OMIT, previous_rank: OMIT,
-                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(threshold:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:,
+                   end_: OMIT, rank: OMIT, previous_rank: OMIT, breakdown_attribute_value: OMIT, breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, run_unit: OMIT, additional_properties: nil)
       @end_ = end_ if end_ != OMIT
       @rank = rank if rank != OMIT
       @previous_rank = previous_rank if previous_rank != OMIT
       @threshold = threshold
+      @breakdown_attribute_value = breakdown_attribute_value if breakdown_attribute_value != OMIT
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -105,10 +115,12 @@ module TrophyApiClient
         "rank": rank,
         "previousRank": previous_rank,
         "threshold": threshold,
+        "breakdownAttributeValue": breakdown_attribute_value,
         "id": id,
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -134,10 +146,12 @@ module TrophyApiClient
       rank = parsed_json["rank"]
       previous_rank = parsed_json["previousRank"]
       threshold = parsed_json["threshold"]
+      breakdown_attribute_value = parsed_json["breakdownAttributeValue"]
       id = parsed_json["id"]
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -152,10 +166,12 @@ module TrophyApiClient
         rank: rank,
         previous_rank: previous_rank,
         threshold: threshold,
+        breakdown_attribute_value: breakdown_attribute_value,
         id: id,
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -187,10 +203,12 @@ module TrophyApiClient
       obj.rank&.is_a?(Integer) != false || raise("Passed value for field obj.rank is not the expected type, validation failed.")
       obj.previous_rank&.is_a?(Integer) != false || raise("Passed value for field obj.previous_rank is not the expected type, validation failed.")
       obj.threshold.is_a?(Integer) != false || raise("Passed value for field obj.threshold is not the expected type, validation failed.")
+      obj.breakdown_attribute_value&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute_value is not the expected type, validation failed.")
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/user_leaderboard_response.rb

@@ -22,6 +22,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -61,6 +63,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -76,14 +79,15 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UserLeaderboardResponse]
-    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, breakdown_attribute: OMIT, metric_key: OMIT,
+                   metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @rank = rank if rank != OMIT
       @value = value if value != OMIT
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -102,6 +106,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -130,6 +135,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -147,6 +153,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -181,6 +188,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/user_leaderboard_response_with_history.rb

@@ -25,6 +25,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -65,6 +67,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -80,8 +83,8 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UserLeaderboardResponseWithHistory]
-    def initialize(history:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(history:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, breakdown_attribute: OMIT,
+                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @history = history
       @rank = rank if rank != OMIT
       @value = value if value != OMIT
@@ -89,6 +92,7 @@ module TrophyApiClient
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -108,6 +112,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -140,6 +145,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -158,6 +164,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -193,6 +200,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/webhook_user_leaderboard_response.rb

@@ -26,6 +26,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -67,6 +69,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -83,7 +86,7 @@ module TrophyApiClient
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::WebhookUserLeaderboardResponse]
     def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, previous_rank: OMIT, previous_value: OMIT, rank: OMIT, value: OMIT,
-                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+                   breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @previous_rank = previous_rank if previous_rank != OMIT
       @previous_value = previous_value if previous_value != OMIT
       @rank = rank if rank != OMIT
@@ -92,6 +95,7 @@ module TrophyApiClient
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -112,6 +116,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -142,6 +147,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -161,6 +167,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -197,6 +204,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/version.rb

@@ -1,3 +1,3 @@
 module MyGem
-  VERSION = "1.0.30"
+  VERSION = "1.0.31"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trophy_api_client
 version: !ruby/object:Gem::Version
-  version: 1.0.30
+  version: 1.0.31
 platform: ruby
 authors:
 - Trophy Labs, Inc