brevo 2.0.0 → 3.0.0

data/docs/WhatsAppCampaignsApi.md

@@ -388,7 +388,8 @@ opts = {
   end_date: 'end_date_example', # String | **Mandatory if startDate is used**. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. **Prefer to pass your timezone in date-time format for accurate result** 
   limit: 50, # Integer | Number of documents per page
   offset: 0, # Integer | Index of the first document in the page
-  sort: 'desc' # String | Sort the results in the ascending/descending order of record modification. Default order is **descending** if `sort` is not passed
+  sort: 'desc', # String | Sort the results in the ascending/descending order of record modification. Default order is **descending** if `sort` is not passed
+  source: 'source_example' # String | source of the template
 }
 
 begin
@@ -409,6 +410,7 @@ Name | Type | Description  | Notes
  **limit** | **Integer**| Number of documents per page | [optional] [default to 50]
  **offset** | **Integer**| Index of the first document in the page | [optional] [default to 0]
  **sort** | **String**| Sort the results in the ascending/descending order of record modification. Default order is **descending** if `sort` is not passed | [optional] [default to desc]
+ **source** | **String**| source of the template | [optional] 
 
 ### Return type
 

data/lib/brevo/api/companies_api.rb

@@ -366,7 +366,7 @@ module Brevo
     # Create a company
     # @param body Company create data.
     # @param [Hash] opts the optional parameters
-    # @return [InlineResponse200]
+    # @return [InlineResponse2002]
     def companies_post(body, opts = {})
       data, _status_code, _headers = companies_post_with_http_info(body, opts)
       data
@@ -375,7 +375,7 @@ module Brevo
     # Create a company
     # @param body Company create data.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(InlineResponse200, Fixnum, Hash)>] InlineResponse200 data, response status code and response headers
+    # @return [Array<(InlineResponse2002, Fixnum, Hash)>] InlineResponse2002 data, response status code and response headers
     def companies_post_with_http_info(body, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: CompaniesApi.companies_post ...'
@@ -409,7 +409,7 @@ module Brevo
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'InlineResponse200')
+        :return_type => 'InlineResponse2002')
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: CompaniesApi#companies_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end

data/lib/brevo/api/contacts_api.rb

@@ -746,6 +746,8 @@ module Brevo
     # @option opts [String] :modified_since Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
     # @option opts [String] :created_since Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
     # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed (default to desc)
+    # @option opts [Integer] :segment_id Id of the segment. **Either listIds or segmentId can be passed.**
+    # @option opts [Array<Integer>] :list_ids Ids of the list. **Either listIds or segmentId can be passed.**
     # @return [GetContacts]
     def get_contacts(opts = {})
       data, _status_code, _headers = get_contacts_with_http_info(opts)
@@ -759,6 +761,8 @@ module Brevo
     # @option opts [String] :modified_since Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
     # @option opts [String] :created_since Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
     # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if &#x60;sort&#x60; is not passed
+    # @option opts [Integer] :segment_id Id of the segment. **Either listIds or segmentId can be passed.**
+    # @option opts [Array<Integer>] :list_ids Ids of the list. **Either listIds or segmentId can be passed.**
     # @return [Array<(GetContacts, Fixnum, Hash)>] GetContacts data, response status code and response headers
     def get_contacts_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -785,6 +789,8 @@ module Brevo
       query_params[:'modifiedSince'] = opts[:'modified_since'] if !opts[:'modified_since'].nil?
       query_params[:'createdSince'] = opts[:'created_since'] if !opts[:'created_since'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'segmentId'] = opts[:'segment_id'] if !opts[:'segment_id'].nil?
+      query_params[:'listIds'] = @api_client.build_collection_param(opts[:'list_ids'], :csv) if !opts[:'list_ids'].nil?
 
       # header parameters
       header_params = {}
@@ -1087,6 +1093,8 @@ module Brevo
     # Get a list's details
     # @param list_id Id of the list
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :start_date Mandatory if endDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result
+    # @option opts [String] :end_date Mandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result
     # @return [GetExtendedList]
     def get_list(list_id, opts = {})
       data, _status_code, _headers = get_list_with_http_info(list_id, opts)
@@ -1096,6 +1104,8 @@ module Brevo
     # Get a list&#39;s details
     # @param list_id Id of the list
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :start_date Mandatory if endDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result
+    # @option opts [String] :end_date Mandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to aggregate the sent email campaigns for a specific list id.Prefer to pass your timezone in date-time format for accurate result
     # @return [Array<(GetExtendedList, Fixnum, Hash)>] GetExtendedList data, response status code and response headers
     def get_list_with_http_info(list_id, opts = {})
       if @api_client.config.debugging
@@ -1110,6 +1120,8 @@ module Brevo
 
       # query parameters
       query_params = {}
+      query_params[:'startDate'] = opts[:'start_date'] if !opts[:'start_date'].nil?
+      query_params[:'endDate'] = opts[:'end_date'] if !opts[:'end_date'].nil?
 
       # header parameters
       header_params = {}
@@ -1277,7 +1289,7 @@ module Brevo
       return data, status_code, headers
     end
     # Import contacts
-    # It returns the background process ID which on completion calls the notify URL that you have set in the input.
+    # It returns the background process ID which on completion calls the notify URL that you have set in the input.  **Note**: - Any contact attribute that doesn't exist in your account will be ignored at import end. 
     # @param request_contact_import Values to import contacts in Brevo. To know more about the expected format, please have a look at &#x60;&#x60;https://help.brevo.com/hc/en-us/articles/209499265-Build-contacts-lists-for-your-email-marketing-campaigns&#x60;&#x60;
     # @param [Hash] opts the optional parameters
     # @return [CreatedProcessId]
@@ -1287,7 +1299,7 @@ module Brevo
     end
 
     # Import contacts
-    # It returns the background process ID which on completion calls the notify URL that you have set in the input.
+    # It returns the background process ID which on completion calls the notify URL that you have set in the input.  **Note**: - Any contact attribute that doesn&#39;t exist in your account will be ignored at import end. 
     # @param request_contact_import Values to import contacts in Brevo. To know more about the expected format, please have a look at &#x60;&#x60;https://help.brevo.com/hc/en-us/articles/209499265-Build-contacts-lists-for-your-email-marketing-campaigns&#x60;&#x60;
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreatedProcessId, Fixnum, Hash)>] CreatedProcessId data, response status code and response headers

data/lib/brevo/api/conversations_api.rb

@@ -191,7 +191,7 @@ module Brevo
     # Only agents’ messages can be edited.
     # @param id ID of the message
     # @param [Hash] opts the optional parameters
-    # @option opts [Body9] :body 
+    # @option opts [Body12] :body 
     # @return [ConversationsMessage]
     def conversations_messages_id_put(id, opts = {})
       data, _status_code, _headers = conversations_messages_id_put_with_http_info(id, opts)
@@ -202,7 +202,7 @@ module Brevo
     # Only agents’ messages can be edited.
     # @param id ID of the message
     # @param [Hash] opts the optional parameters
-    # @option opts [Body9] :body 
+    # @option opts [Body12] :body 
     # @return [Array<(ConversationsMessage, Fixnum, Hash)>] ConversationsMessage data, response status code and response headers
     def conversations_messages_id_put_with_http_info(id, opts = {})
       if @api_client.config.debugging

data/lib/brevo/api/coupons_api.rb

@@ -32,7 +32,7 @@ module Brevo
     # Create а coupon collection
     # @param create_coupon_collection Values to create a coupon collection
     # @param [Hash] opts the optional parameters
-    # @return [InlineResponse2012]
+    # @return [InlineResponse2013]
     def create_coupon_collection(create_coupon_collection, opts = {})
       data, _status_code, _headers = create_coupon_collection_with_http_info(create_coupon_collection, opts)
       data
@@ -41,7 +41,7 @@ module Brevo
     # Create а coupon collection
     # @param create_coupon_collection Values to create a coupon collection
     # @param [Hash] opts the optional parameters
-    # @return [Array<(InlineResponse2012, Fixnum, Hash)>] InlineResponse2012 data, response status code and response headers
+    # @return [Array<(InlineResponse2013, Fixnum, Hash)>] InlineResponse2013 data, response status code and response headers
     def create_coupon_collection_with_http_info(create_coupon_collection, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: CouponsApi.create_coupon_collection ...'
@@ -75,7 +75,7 @@ module Brevo
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'InlineResponse2012')
+        :return_type => 'InlineResponse2013')
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: CouponsApi#create_coupon_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
@@ -189,6 +189,7 @@ module Brevo
     # @option opts [Integer] :limit Number of documents returned per page (default to 50)
     # @option opts [Integer] :offset Index of the first document on the page (default to 0)
     # @option opts [String] :sort Sort the results by creation time in ascending/descending order (default to desc)
+    # @option opts [Object] :sort_by The field used to sort coupon collections
     # @return [GetCouponCollection]
     def get_coupon_collections(opts = {})
       data, _status_code, _headers = get_coupon_collections_with_http_info(opts)
@@ -200,6 +201,7 @@ module Brevo
     # @option opts [Integer] :limit Number of documents returned per page
     # @option opts [Integer] :offset Index of the first document on the page
     # @option opts [String] :sort Sort the results by creation time in ascending/descending order
+    # @option opts [Object] :sort_by The field used to sort coupon collections
     # @return [Array<(GetCouponCollection, Fixnum, Hash)>] GetCouponCollection data, response status code and response headers
     def get_coupon_collections_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -228,6 +230,7 @@ module Brevo
       query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
       query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'sortBy'] = opts[:'sort_by'] if !opts[:'sort_by'].nil?
 
       # header parameters
       header_params = {}
@@ -256,20 +259,20 @@ module Brevo
     end
     # Update a coupon collection by id
     # @param id Id of the collection to update
-    # @param update_coupon_collection Values to update the coupon collection
     # @param [Hash] opts the optional parameters
-    # @return [InlineResponse2001]
-    def update_coupon_collection(id, update_coupon_collection, opts = {})
-      data, _status_code, _headers = update_coupon_collection_with_http_info(id, update_coupon_collection, opts)
+    # @option opts [UpdateCouponCollection] :update_coupon_collection Values to update the coupon collection
+    # @return [InlineResponse2003]
+    def update_coupon_collection(id, opts = {})
+      data, _status_code, _headers = update_coupon_collection_with_http_info(id, opts)
       data
     end
 
     # Update a coupon collection by id
     # @param id Id of the collection to update
-    # @param update_coupon_collection Values to update the coupon collection
     # @param [Hash] opts the optional parameters
-    # @return [Array<(InlineResponse2001, Fixnum, Hash)>] InlineResponse2001 data, response status code and response headers
-    def update_coupon_collection_with_http_info(id, update_coupon_collection, opts = {})
+    # @option opts [UpdateCouponCollection] :update_coupon_collection Values to update the coupon collection
+    # @return [Array<(InlineResponse2003, Fixnum, Hash)>] InlineResponse2003 data, response status code and response headers
+    def update_coupon_collection_with_http_info(id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: CouponsApi.update_coupon_collection ...'
       end
@@ -277,10 +280,6 @@ module Brevo
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling CouponsApi.update_coupon_collection"
       end
-      # verify the required parameter 'update_coupon_collection' is set
-      if @api_client.config.client_side_validation && update_coupon_collection.nil?
-        fail ArgumentError, "Missing the required parameter 'update_coupon_collection' when calling CouponsApi.update_coupon_collection"
-      end
       # resource path
       local_var_path = '/couponCollections/{id}'.sub('{' + 'id' + '}', id.to_s)
 
@@ -298,7 +297,7 @@ module Brevo
       form_params = {}
 
       # http body (model)
-      post_body = @api_client.object_to_http_body(update_coupon_collection)
+      post_body = @api_client.object_to_http_body(opts[:'update_coupon_collection'])
       auth_names = ['api-key', 'partner-key']
       data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
         :header_params => header_params,
@@ -306,7 +305,7 @@ module Brevo
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'InlineResponse2001')
+        :return_type => 'InlineResponse2003')
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: CouponsApi#update_coupon_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end

data/lib/brevo/api/deals_api.rb

@@ -77,7 +77,7 @@ module Brevo
     end
     # Get all deals
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :filters_attributes_deal_name Filter by attributes. If you have filter for owner on your side please send it as `filters[attributes.deal_owner]`.\"
+    # @option opts [String] :filters_attributes_deal_name Filter by attributes. If you have a filter for the owner on your end, please send it as filters[attributes.deal_owner] and utilize the account email for the filtering.
     # @option opts [String] :filters_linked_companies_ids Filter by linked companies ids
     # @option opts [String] :filters_linked_contacts_ids Filter by linked companies ids
     # @option opts [Integer] :offset Index of the first document of the page
@@ -92,7 +92,7 @@ module Brevo
 
     # Get all deals
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :filters_attributes_deal_name Filter by attributes. If you have filter for owner on your side please send it as `filters[attributes.deal_owner]`.\"
+    # @option opts [String] :filters_attributes_deal_name Filter by attributes. If you have a filter for the owner on your end, please send it as filters[attributes.deal_owner] and utilize the account email for the filtering.
     # @option opts [String] :filters_linked_companies_ids Filter by linked companies ids
     # @option opts [String] :filters_linked_contacts_ids Filter by linked companies ids
     # @option opts [Integer] :offset Index of the first document of the page
@@ -365,7 +365,7 @@ module Brevo
     # Create a deal
     # @param body Deal create data.
     # @param [Hash] opts the optional parameters
-    # @return [InlineResponse201]
+    # @return [InlineResponse2011]
     def crm_deals_post(body, opts = {})
       data, _status_code, _headers = crm_deals_post_with_http_info(body, opts)
       data
@@ -374,7 +374,7 @@ module Brevo
     # Create a deal
     # @param body Deal create data.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(InlineResponse201, Fixnum, Hash)>] InlineResponse201 data, response status code and response headers
+    # @return [Array<(InlineResponse2011, Fixnum, Hash)>] InlineResponse2011 data, response status code and response headers
     def crm_deals_post_with_http_info(body, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: DealsApi.crm_deals_post ...'
@@ -408,7 +408,7 @@ module Brevo
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => 'InlineResponse201')
+        :return_type => 'InlineResponse2011')
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: DealsApi#crm_deals_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end

data/lib/brevo/api/ecommerce_api.rb

@@ -390,6 +390,174 @@ module Brevo
       end
       return data, status_code, headers
     end
+    # Get detailed attribution metrics for a single Brevo campaign
+    # @param conversion_source The Brevo campaign type for which data will be retrieved
+    # @param conversion_source_id The Brevo campaign id for which data will be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def ecommerce_attribution_metrics_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id, opts = {})
+      ecommerce_attribution_metrics_conversion_source_conversion_source_id_get_with_http_info(conversion_source, conversion_source_id, opts)
+      nil
+    end
+
+    # Get detailed attribution metrics for a single Brevo campaign
+    # @param conversion_source The Brevo campaign type for which data will be retrieved
+    # @param conversion_source_id The Brevo campaign id for which data will be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def ecommerce_attribution_metrics_conversion_source_conversion_source_id_get_with_http_info(conversion_source, conversion_source_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EcommerceApi.ecommerce_attribution_metrics_conversion_source_conversion_source_id_get ...'
+      end
+      # verify the required parameter 'conversion_source' is set
+      if @api_client.config.client_side_validation && conversion_source.nil?
+        fail ArgumentError, "Missing the required parameter 'conversion_source' when calling EcommerceApi.ecommerce_attribution_metrics_conversion_source_conversion_source_id_get"
+      end
+      # verify the required parameter 'conversion_source_id' is set
+      if @api_client.config.client_side_validation && conversion_source_id.nil?
+        fail ArgumentError, "Missing the required parameter 'conversion_source_id' when calling EcommerceApi.ecommerce_attribution_metrics_conversion_source_conversion_source_id_get"
+      end
+      # resource path
+      local_var_path = '/ecommerce/attribution/metrics/{conversionSource}/{conversionSourceId}'.sub('{' + 'conversionSource' + '}', conversion_source.to_s).sub('{' + 'conversionSourceId' + '}', conversion_source_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['api-key', 'partner-key']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EcommerceApi#ecommerce_attribution_metrics_conversion_source_conversion_source_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get attribution metrics for one or more Brevo campaigns
+    # @param [Hash] opts the optional parameters
+    # @option opts [Object] :period_from When getting metrics for a specific period, define the starting datetime in RFC3339 format
+    # @option opts [Object] :period_to When getting metrics for a specific period, define the end datetime in RFC3339 format
+    # @option opts [Object] :email_campaign_id The email campaign id(s) to get metrics for
+    # @return [nil]
+    def ecommerce_attribution_metrics_get(opts = {})
+      ecommerce_attribution_metrics_get_with_http_info(opts)
+      nil
+    end
+
+    # Get attribution metrics for one or more Brevo campaigns
+    # @param [Hash] opts the optional parameters
+    # @option opts [Object] :period_from When getting metrics for a specific period, define the starting datetime in RFC3339 format
+    # @option opts [Object] :period_to When getting metrics for a specific period, define the end datetime in RFC3339 format
+    # @option opts [Object] :email_campaign_id The email campaign id(s) to get metrics for
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def ecommerce_attribution_metrics_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EcommerceApi.ecommerce_attribution_metrics_get ...'
+      end
+      # resource path
+      local_var_path = '/ecommerce/attribution/metrics'
+
+      # query parameters
+      query_params = {}
+      query_params[:'periodFrom'] = opts[:'period_from'] if !opts[:'period_from'].nil?
+      query_params[:'periodTo'] = opts[:'period_to'] if !opts[:'period_to'].nil?
+      query_params[:'emailCampaignId[]'] = opts[:'email_campaign_id'] if !opts[:'email_campaign_id'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['api-key', 'partner-key']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EcommerceApi#ecommerce_attribution_metrics_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get attributed product sales for a single Brevo campaign
+    # @param conversion_source The Brevo campaign type for which data will be retrieved
+    # @param conversion_source_id The Brevo campaign id for which data will be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def ecommerce_attribution_products_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id, opts = {})
+      ecommerce_attribution_products_conversion_source_conversion_source_id_get_with_http_info(conversion_source, conversion_source_id, opts)
+      nil
+    end
+
+    # Get attributed product sales for a single Brevo campaign
+    # @param conversion_source The Brevo campaign type for which data will be retrieved
+    # @param conversion_source_id The Brevo campaign id for which data will be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def ecommerce_attribution_products_conversion_source_conversion_source_id_get_with_http_info(conversion_source, conversion_source_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EcommerceApi.ecommerce_attribution_products_conversion_source_conversion_source_id_get ...'
+      end
+      # verify the required parameter 'conversion_source' is set
+      if @api_client.config.client_side_validation && conversion_source.nil?
+        fail ArgumentError, "Missing the required parameter 'conversion_source' when calling EcommerceApi.ecommerce_attribution_products_conversion_source_conversion_source_id_get"
+      end
+      # verify the required parameter 'conversion_source_id' is set
+      if @api_client.config.client_side_validation && conversion_source_id.nil?
+        fail ArgumentError, "Missing the required parameter 'conversion_source_id' when calling EcommerceApi.ecommerce_attribution_products_conversion_source_conversion_source_id_get"
+      end
+      # resource path
+      local_var_path = '/ecommerce/attribution/products/{conversionSource}/{conversionSourceId}'.sub('{' + 'conversionSource' + '}', conversion_source.to_s).sub('{' + 'conversionSourceId' + '}', conversion_source_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['api-key', 'partner-key']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EcommerceApi#ecommerce_attribution_products_conversion_source_conversion_source_id_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
     # Return all your categories
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :limit Number of documents per page (default to 50)
@@ -397,6 +565,8 @@ module Brevo
     # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if &#x60;sort&#x60; is not passed (default to desc)
     # @option opts [Array<String>] :ids Filter by category ids
     # @option opts [String] :name Filter by category name
+    # @option opts [String] :modified_since Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**         
+    # @option opts [String] :created_since Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**         
     # @return [GetCategories]
     def get_categories(opts = {})
       data, _status_code, _headers = get_categories_with_http_info(opts)
@@ -410,6 +580,8 @@ module Brevo
     # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if &#x60;sort&#x60; is not passed
     # @option opts [Array<String>] :ids Filter by category ids
     # @option opts [String] :name Filter by category name
+    # @option opts [String] :modified_since Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**         
+    # @option opts [String] :created_since Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**         
     # @return [Array<(GetCategories, Fixnum, Hash)>] GetCategories data, response status code and response headers
     def get_categories_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -432,6 +604,8 @@ module Brevo
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
       query_params[:'ids'] = @api_client.build_collection_param(opts[:'ids'], :csv) if !opts[:'ids'].nil?
       query_params[:'name'] = opts[:'name'] if !opts[:'name'].nil?
+      query_params[:'modifiedSince'] = opts[:'modified_since'] if !opts[:'modified_since'].nil?
+      query_params[:'createdSince'] = opts[:'created_since'] if !opts[:'created_since'].nil?
 
       # header parameters
       header_params = {}
@@ -510,6 +684,76 @@ module Brevo
       end
       return data, status_code, headers
     end
+    # Get order details
+    # Get all the orders
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Number of documents per page (default to 50)
+    # @option opts [Integer] :offset Index of the first document in the page (default to 0)
+    # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if &#x60;sort&#x60; is not passed (default to desc)
+    # @option opts [String] :modified_since Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @option opts [String] :created_since Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @return [GetOrders]
+    def get_orders(opts = {})
+      data, _status_code, _headers = get_orders_with_http_info(opts)
+      data
+    end
+
+    # Get order details
+    # Get all the orders
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit Number of documents per page
+    # @option opts [Integer] :offset Index of the first document in the page
+    # @option opts [String] :sort Sort the results in the ascending/descending order of record creation. Default order is **descending** if &#x60;sort&#x60; is not passed
+    # @option opts [String] :modified_since Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @option opts [String] :created_since Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @return [Array<(GetOrders, Fixnum, Hash)>] GetOrders data, response status code and response headers
+    def get_orders_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EcommerceApi.get_orders ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling EcommerceApi.get_orders, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && opts[:'sort'] && !['asc', 'desc'].include?(opts[:'sort'])
+        fail ArgumentError, 'invalid value for "sort", must be one of asc, desc'
+      end
+      # resource path
+      local_var_path = '/orders'
+
+      # query parameters
+      query_params = {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'modifiedSince'] = opts[:'modified_since'] if !opts[:'modified_since'].nil?
+      query_params[:'createdSince'] = opts[:'created_since'] if !opts[:'created_since'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['api-key', 'partner-key']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'GetOrders')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EcommerceApi#get_orders\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
     # Get a product's details
     # @param id Product ID
     # @param [Hash] opts the optional parameters
@@ -576,6 +820,8 @@ module Brevo
     # @option opts [Float] :price_eq Price filter for products equals to particular amount
     # @option opts [Float] :price_ne Price filter for products not equals to particular amount
     # @option opts [Array<String>] :categories Filter by category ids
+    # @option opts [String] :modified_since Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @option opts [String] :created_since Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
     # @return [GetProducts]
     def get_products(opts = {})
       data, _status_code, _headers = get_products_with_http_info(opts)
@@ -596,6 +842,8 @@ module Brevo
     # @option opts [Float] :price_eq Price filter for products equals to particular amount
     # @option opts [Float] :price_ne Price filter for products not equals to particular amount
     # @option opts [Array<String>] :categories Filter by category ids
+    # @option opts [String] :modified_since Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
+    # @option opts [String] :created_since Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.** 
     # @return [Array<(GetProducts, Fixnum, Hash)>] GetProducts data, response status code and response headers
     def get_products_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -625,6 +873,8 @@ module Brevo
       query_params[:'price[eq]'] = opts[:'price_eq'] if !opts[:'price_eq'].nil?
       query_params[:'price[ne]'] = opts[:'price_ne'] if !opts[:'price_ne'].nil?
       query_params[:'categories'] = @api_client.build_collection_param(opts[:'categories'], :csv) if !opts[:'categories'].nil?
+      query_params[:'modifiedSince'] = opts[:'modified_since'] if !opts[:'modified_since'].nil?
+      query_params[:'createdSince'] = opts[:'created_since'] if !opts[:'created_since'].nil?
 
       # header parameters
       header_params = {}

data/lib/brevo/api/email_campaigns_api.rb

@@ -244,7 +244,6 @@ module Brevo
     # @param campaign_id Id of the campaign
     # @param [Hash] opts the optional parameters
     # @option opts [String] :statistics Filter on the type of statistics required. Example **globalStats** value will only fetch globalStats info of the campaign in returned response.
-    # @option opts [String] :utm_value Get email campaign report on the basis of custom UTM Value.**You can use either campaignId or utmValue to fetch campaign report.To use utmValue filter pass campaignId as empty.**
     # @return [GetEmailCampaign]
     def get_email_campaign(campaign_id, opts = {})
       data, _status_code, _headers = get_email_campaign_with_http_info(campaign_id, opts)
@@ -255,7 +254,6 @@ module Brevo
     # @param campaign_id Id of the campaign
     # @param [Hash] opts the optional parameters
     # @option opts [String] :statistics Filter on the type of statistics required. Example **globalStats** value will only fetch globalStats info of the campaign in returned response.
-    # @option opts [String] :utm_value Get email campaign report on the basis of custom UTM Value.**You can use either campaignId or utmValue to fetch campaign report.To use utmValue filter pass campaignId as empty.**
     # @return [Array<(GetEmailCampaign, Fixnum, Hash)>] GetEmailCampaign data, response status code and response headers
     def get_email_campaign_with_http_info(campaign_id, opts = {})
       if @api_client.config.debugging
@@ -274,7 +272,6 @@ module Brevo
       # query parameters
       query_params = {}
       query_params[:'statistics'] = opts[:'statistics'] if !opts[:'statistics'].nil?
-      query_params[:'utmValue'] = opts[:'utm_value'] if !opts[:'utm_value'].nil?
 
       # header parameters
       header_params = {}