growwer 1.0.0

data/lib/growwer/api/catalogue_api.rb

@@ -0,0 +1,881 @@
+=begin
+#Growwer API
+
+#The Growwer customer API. Authenticate every call with an API key created on your profile page, sent as `Authorization: Bearer <key>`. A read key can call every GET operation; writes need a read and write key and an `Idempotency-Key` header.  Idempotency: use a new `Idempotency-Key` (1 to 255 printable ASCII characters without spaces) for each operation and reuse it only to retry that same operation. Keys belong to your account, not to one API key. - A successful write is stored for 30 days: a retry with the same key and   the same request replays its response with `Idempotent-Replayed: true`   and does nothing again. - A refused write (4xx) has no effect and releases its key: once you fix the   cause, retry with the same key and the write runs. - A failed write (5xx) may have taken effect, so it is never run again under   its key: a retry gets 409 `idempotency_outcome_unknown`. Check whether it   took effect before retrying with a new key. - A retry while the first request is still running gets 409   `idempotency_request_in_progress`. A request still running after 5 minutes   is treated as failed: a retry gets 409 `idempotency_outcome_unknown`. - The same key with a different request (method, path, query or body) gets   409 `idempotency_key_reused`. A write without the header gets 400   `idempotency_key_required`.  Every response carries `X-Request-Id`. Errors share one shape, `{code, message, requestId, details?}`. Money is integer cents plus a currency code and dates are ISO-8601. 
+
+The version of the OpenAPI document: 1
+Contact: support@growwer.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.24.0
+
+=end
+
+require 'cgi'
+
+module Growwer
+  class CatalogueApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Discard a media for a project
+    # Discards a media for one of your projects, as the web does. Discarding it again changes nothing. The media must be one the catalogue shows for the project: another media, including one of your own as a seller, is answered as not found.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def discard_media(id, media_id, idempotency_key, opts = {})
+      discard_media_with_http_info(id, media_id, idempotency_key, opts)
+      nil
+    end
+
+    # Discard a media for a project
+    # Discards a media for one of your projects, as the web does. Discarding it again changes nothing. The media must be one the catalogue shows for the project: another media, including one of your own as a seller, is answered as not found.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def discard_media_with_http_info(id, media_id, idempotency_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.discard_media ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.discard_media"
+      end
+      # verify the required parameter 'media_id' is set
+      if @api_client.config.client_side_validation && media_id.nil?
+        fail ArgumentError, "Missing the required parameter 'media_id' when calling CatalogueApi.discard_media"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling CatalogueApi.discard_media"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling CatalogueApi.discard_media, the character length must be smaller than or equal to 255.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/discards/{mediaId}'.sub('{id}', CGI.escape(id.to_s)).sub('{mediaId}', CGI.escape(media_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.discard_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#discard_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Add a media to the favourites of a project
+    # Marks a media as a favourite of one of your projects, as the heart on the web does. Adding a favourite again changes nothing. The media must be one the catalogue shows for the project: another media, including one of your own as a seller, is answered as not found.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def favourite_media(id, media_id, idempotency_key, opts = {})
+      favourite_media_with_http_info(id, media_id, idempotency_key, opts)
+      nil
+    end
+
+    # Add a media to the favourites of a project
+    # Marks a media as a favourite of one of your projects, as the heart on the web does. Adding a favourite again changes nothing. The media must be one the catalogue shows for the project: another media, including one of your own as a seller, is answered as not found.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def favourite_media_with_http_info(id, media_id, idempotency_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.favourite_media ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.favourite_media"
+      end
+      # verify the required parameter 'media_id' is set
+      if @api_client.config.client_side_validation && media_id.nil?
+        fail ArgumentError, "Missing the required parameter 'media_id' when calling CatalogueApi.favourite_media"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling CatalogueApi.favourite_media"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling CatalogueApi.favourite_media, the character length must be smaller than or equal to 255.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/favourites/{mediaId}'.sub('{id}', CGI.escape(id.to_s)).sub('{mediaId}', CGI.escape(media_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.favourite_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#favourite_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a media
+    # One media of the catalogue: an active, public media. A media you have ordered is always readable, even if it has since left the catalogue, and is open to every account. Otherwise the catalogue is open to accounts with recent completed orders (see `catalogue.eligible` on GET /me), and the media counts towards the distinct medias the account may see per day (UTC). For the media's state in one of your projects, search the project with GET /projects/{id}/medias.
+    # @param id [String] The media.
+    # @param [Hash] opts the optional parameters
+    # @return [CatalogueMedia]
+    def get_catalogue_media(id, opts = {})
+      data, _status_code, _headers = get_catalogue_media_with_http_info(id, opts)
+      data
+    end
+
+    # Get a media
+    # One media of the catalogue: an active, public media. A media you have ordered is always readable, even if it has since left the catalogue, and is open to every account. Otherwise the catalogue is open to accounts with recent completed orders (see &#x60;catalogue.eligible&#x60; on GET /me), and the media counts towards the distinct medias the account may see per day (UTC). For the media&#39;s state in one of your projects, search the project with GET /projects/{id}/medias.
+    # @param id [String] The media.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CatalogueMedia, Integer, Hash)>] CatalogueMedia data, response status code and response headers
+    def get_catalogue_media_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.get_catalogue_media ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.get_catalogue_media"
+      end
+      # resource path
+      local_var_path = '/api/v1/medias/{id}'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CatalogueMedia'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.get_catalogue_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#get_catalogue_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List flash offers
+    # The medias on a flash offer, a time-limited discount, in the catalogue of one of your projects. It is GET /projects/{id}/medias with `flashOffer=true`, and takes the same parameters except `flashOffer` and `savedFilterId`. The catalogue access and the daily distinct-media limit of that operation apply.
+    # @param project_id [String] The project to search flash offers for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :source Which of the project&#39;s medias to search: &#x60;all&#x60; (the default), &#x60;recommended&#x60; (those Growwer recommends for the project), or those you marked &#x60;favourite&#x60;, &#x60;discarded&#x60; or &#x60;requested&#x60;, or &#x60;bought&#x60; for the project. Do not combine it with the parameter of the same state.
+    # @option opts [String] :sort The order. Without it, the web&#39;s default order: medias on the project&#39;s topic and language first, then best sellers and medias with more published orders. Ties are always broken by media id, so pages never overlap. &#x60;-growwerRank&#x60;: best match first; &#x60;postPrice&#x60;, &#x60;linkAdditionPrice&#x60;: cheapest first; &#x60;matchedAt&#x60;, &#x60;-matchedAt&#x60;: when Growwer matched the media with the project; &#x60;-traffic&#x60;, &#x60;-domainRating&#x60;, &#x60;-referringDomains&#x60;: highest first; &#x60;linkedToReferringRatio&#x60;: lowest first.
+    # @option opts [String] :domain Medias whose domain contains this text, 1 to 255 characters.
+    # @option opts [String] :website_type A comma-separated list of website types: &#x60;blog&#x60;, &#x60;press&#x60;.
+    # @option opts [String] :language A comma-separated list of language codes, as in GET /vocabulary.
+    # @option opts [String] :country A comma-separated list of country codes, as in GET /vocabulary.
+    # @option opts [String] :topics A comma-separated list of topic ids, as in GET /vocabulary: medias on any of them.
+    # @option opts [Boolean] :not_banned_topics Leave out medias that refuse the topic of the project. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_traffic Minimum monthly organic traffic.
+    # @option opts [Integer] :max_traffic Maximum monthly organic traffic.
+    # @option opts [Boolean] :traffic_trend_upward Medias whose traffic is growing. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_domain_rating Minimum domain rating, 0 to 100.
+    # @option opts [Integer] :max_domain_rating Maximum domain rating, 0 to 100.
+    # @option opts [Float] :min_linked_to_referring_ratio Minimum ratio of linked domains to referring domains, such as 0.5.
+    # @option opts [Float] :max_linked_to_referring_ratio Maximum ratio of linked domains to referring domains, such as 1.5.
+    # @option opts [Integer] :min_post_price Minimum post price, in cents.
+    # @option opts [Integer] :max_post_price Maximum post price, in cents.
+    # @option opts [String] :post_link_type A comma-separated list of link types the post offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [String] :promoted_social_network A comma-separated list of social networks the media promotes posts on: &#x60;twitter&#x60;, &#x60;instagram&#x60;, &#x60;facebook&#x60;, &#x60;pinterest&#x60;, &#x60;tumblr&#x60;, &#x60;newsletter&#x60;.
+    # @option opts [Boolean] :without_advertising_label Medias that never label posts as advertising. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :homepage_listing Medias that offer listing the post on their homepage. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :has_link_addition Medias that offer adding a link to an existing article. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_link_addition_price Minimum link addition price, in cents.
+    # @option opts [Integer] :max_link_addition_price Maximum link addition price, in cents.
+    # @option opts [String] :link_addition_link_type A comma-separated list of link types the link addition offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [Boolean] :recommended &#x60;true&#x60;: only the medias Growwer recommends for the project; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :favourite &#x60;true&#x60;: only your favourites for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :requested &#x60;true&#x60;: only the medias you requested for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :bought &#x60;true&#x60;: only medias you bought for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :discarded &#x60;true&#x60;: only the medias you discarded for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :new Medias Growwer matched with the project recently. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [String] :ranks_goal_keyword A comma-separated list of keyword origins: medias that rank for a keyword of the project from any of them. &#x60;user&#x60;: your keywords; &#x60;publicGenerated&#x60;: keywords Growwer found for the project.
+    # @option opts [String] :ranks_ai_keyword A comma-separated list of AI answer engines: medias cited for a keyword of the project by any of them. &#x60;googleAiOverview&#x60;, &#x60;chatgpt&#x60;, &#x60;googleAiMode&#x60;.
+    # @option opts [Integer] :limit Medias per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Medias to skip, at most 99900. (default to 0)
+    # @return [ListFlashOffers200Response]
+    def list_flash_offers(project_id, opts = {})
+      data, _status_code, _headers = list_flash_offers_with_http_info(project_id, opts)
+      data
+    end
+
+    # List flash offers
+    # The medias on a flash offer, a time-limited discount, in the catalogue of one of your projects. It is GET /projects/{id}/medias with &#x60;flashOffer&#x3D;true&#x60;, and takes the same parameters except &#x60;flashOffer&#x60; and &#x60;savedFilterId&#x60;. The catalogue access and the daily distinct-media limit of that operation apply.
+    # @param project_id [String] The project to search flash offers for.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :source Which of the project&#39;s medias to search: &#x60;all&#x60; (the default), &#x60;recommended&#x60; (those Growwer recommends for the project), or those you marked &#x60;favourite&#x60;, &#x60;discarded&#x60; or &#x60;requested&#x60;, or &#x60;bought&#x60; for the project. Do not combine it with the parameter of the same state.
+    # @option opts [String] :sort The order. Without it, the web&#39;s default order: medias on the project&#39;s topic and language first, then best sellers and medias with more published orders. Ties are always broken by media id, so pages never overlap. &#x60;-growwerRank&#x60;: best match first; &#x60;postPrice&#x60;, &#x60;linkAdditionPrice&#x60;: cheapest first; &#x60;matchedAt&#x60;, &#x60;-matchedAt&#x60;: when Growwer matched the media with the project; &#x60;-traffic&#x60;, &#x60;-domainRating&#x60;, &#x60;-referringDomains&#x60;: highest first; &#x60;linkedToReferringRatio&#x60;: lowest first.
+    # @option opts [String] :domain Medias whose domain contains this text, 1 to 255 characters.
+    # @option opts [String] :website_type A comma-separated list of website types: &#x60;blog&#x60;, &#x60;press&#x60;.
+    # @option opts [String] :language A comma-separated list of language codes, as in GET /vocabulary.
+    # @option opts [String] :country A comma-separated list of country codes, as in GET /vocabulary.
+    # @option opts [String] :topics A comma-separated list of topic ids, as in GET /vocabulary: medias on any of them.
+    # @option opts [Boolean] :not_banned_topics Leave out medias that refuse the topic of the project. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_traffic Minimum monthly organic traffic.
+    # @option opts [Integer] :max_traffic Maximum monthly organic traffic.
+    # @option opts [Boolean] :traffic_trend_upward Medias whose traffic is growing. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_domain_rating Minimum domain rating, 0 to 100.
+    # @option opts [Integer] :max_domain_rating Maximum domain rating, 0 to 100.
+    # @option opts [Float] :min_linked_to_referring_ratio Minimum ratio of linked domains to referring domains, such as 0.5.
+    # @option opts [Float] :max_linked_to_referring_ratio Maximum ratio of linked domains to referring domains, such as 1.5.
+    # @option opts [Integer] :min_post_price Minimum post price, in cents.
+    # @option opts [Integer] :max_post_price Maximum post price, in cents.
+    # @option opts [String] :post_link_type A comma-separated list of link types the post offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [String] :promoted_social_network A comma-separated list of social networks the media promotes posts on: &#x60;twitter&#x60;, &#x60;instagram&#x60;, &#x60;facebook&#x60;, &#x60;pinterest&#x60;, &#x60;tumblr&#x60;, &#x60;newsletter&#x60;.
+    # @option opts [Boolean] :without_advertising_label Medias that never label posts as advertising. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :homepage_listing Medias that offer listing the post on their homepage. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :has_link_addition Medias that offer adding a link to an existing article. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_link_addition_price Minimum link addition price, in cents.
+    # @option opts [Integer] :max_link_addition_price Maximum link addition price, in cents.
+    # @option opts [String] :link_addition_link_type A comma-separated list of link types the link addition offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [Boolean] :recommended &#x60;true&#x60;: only the medias Growwer recommends for the project; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :favourite &#x60;true&#x60;: only your favourites for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :requested &#x60;true&#x60;: only the medias you requested for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :bought &#x60;true&#x60;: only medias you bought for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :discarded &#x60;true&#x60;: only the medias you discarded for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :new Medias Growwer matched with the project recently. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [String] :ranks_goal_keyword A comma-separated list of keyword origins: medias that rank for a keyword of the project from any of them. &#x60;user&#x60;: your keywords; &#x60;publicGenerated&#x60;: keywords Growwer found for the project.
+    # @option opts [String] :ranks_ai_keyword A comma-separated list of AI answer engines: medias cited for a keyword of the project by any of them. &#x60;googleAiOverview&#x60;, &#x60;chatgpt&#x60;, &#x60;googleAiMode&#x60;.
+    # @option opts [Integer] :limit Medias per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Medias to skip, at most 99900. (default to 0)
+    # @return [Array<(ListFlashOffers200Response, Integer, Hash)>] ListFlashOffers200Response data, response status code and response headers
+    def list_flash_offers_with_http_info(project_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.list_flash_offers ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling CatalogueApi.list_flash_offers"
+      end
+      allowable_values = ["all", "recommended", "favourite", "discarded", "requested", "bought"]
+      if @api_client.config.client_side_validation && opts[:'source'] && !allowable_values.include?(opts[:'source'])
+        fail ArgumentError, "invalid value for \"source\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["-growwerRank", "postPrice", "linkAdditionPrice", "matchedAt", "-matchedAt", "-traffic", "-domainRating", "linkedToReferringRatio", "-referringDomains"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CatalogueApi.list_flash_offers, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CatalogueApi.list_flash_offers, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] > 99900
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling CatalogueApi.list_flash_offers, must be smaller than or equal to 99900.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling CatalogueApi.list_flash_offers, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/flash-offers'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'projectId'] = project_id
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'domain'] = opts[:'domain'] if !opts[:'domain'].nil?
+      query_params[:'websiteType'] = opts[:'website_type'] if !opts[:'website_type'].nil?
+      query_params[:'language'] = opts[:'language'] if !opts[:'language'].nil?
+      query_params[:'country'] = opts[:'country'] if !opts[:'country'].nil?
+      query_params[:'topics'] = opts[:'topics'] if !opts[:'topics'].nil?
+      query_params[:'notBannedTopics'] = opts[:'not_banned_topics'] if !opts[:'not_banned_topics'].nil?
+      query_params[:'minTraffic'] = opts[:'min_traffic'] if !opts[:'min_traffic'].nil?
+      query_params[:'maxTraffic'] = opts[:'max_traffic'] if !opts[:'max_traffic'].nil?
+      query_params[:'trafficTrendUpward'] = opts[:'traffic_trend_upward'] if !opts[:'traffic_trend_upward'].nil?
+      query_params[:'minDomainRating'] = opts[:'min_domain_rating'] if !opts[:'min_domain_rating'].nil?
+      query_params[:'maxDomainRating'] = opts[:'max_domain_rating'] if !opts[:'max_domain_rating'].nil?
+      query_params[:'minLinkedToReferringRatio'] = opts[:'min_linked_to_referring_ratio'] if !opts[:'min_linked_to_referring_ratio'].nil?
+      query_params[:'maxLinkedToReferringRatio'] = opts[:'max_linked_to_referring_ratio'] if !opts[:'max_linked_to_referring_ratio'].nil?
+      query_params[:'minPostPrice'] = opts[:'min_post_price'] if !opts[:'min_post_price'].nil?
+      query_params[:'maxPostPrice'] = opts[:'max_post_price'] if !opts[:'max_post_price'].nil?
+      query_params[:'postLinkType'] = opts[:'post_link_type'] if !opts[:'post_link_type'].nil?
+      query_params[:'promotedSocialNetwork'] = opts[:'promoted_social_network'] if !opts[:'promoted_social_network'].nil?
+      query_params[:'withoutAdvertisingLabel'] = opts[:'without_advertising_label'] if !opts[:'without_advertising_label'].nil?
+      query_params[:'homepageListing'] = opts[:'homepage_listing'] if !opts[:'homepage_listing'].nil?
+      query_params[:'hasLinkAddition'] = opts[:'has_link_addition'] if !opts[:'has_link_addition'].nil?
+      query_params[:'minLinkAdditionPrice'] = opts[:'min_link_addition_price'] if !opts[:'min_link_addition_price'].nil?
+      query_params[:'maxLinkAdditionPrice'] = opts[:'max_link_addition_price'] if !opts[:'max_link_addition_price'].nil?
+      query_params[:'linkAdditionLinkType'] = opts[:'link_addition_link_type'] if !opts[:'link_addition_link_type'].nil?
+      query_params[:'recommended'] = opts[:'recommended'] if !opts[:'recommended'].nil?
+      query_params[:'favourite'] = opts[:'favourite'] if !opts[:'favourite'].nil?
+      query_params[:'requested'] = opts[:'requested'] if !opts[:'requested'].nil?
+      query_params[:'bought'] = opts[:'bought'] if !opts[:'bought'].nil?
+      query_params[:'discarded'] = opts[:'discarded'] if !opts[:'discarded'].nil?
+      query_params[:'new'] = opts[:'new'] if !opts[:'new'].nil?
+      query_params[:'ranksGoalKeyword'] = opts[:'ranks_goal_keyword'] if !opts[:'ranks_goal_keyword'].nil?
+      query_params[:'ranksAiKeyword'] = opts[:'ranks_ai_keyword'] if !opts[:'ranks_ai_keyword'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListFlashOffers200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.list_flash_offers",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#list_flash_offers\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Request specific medias for a project
+    # Asks Growwer to find the medias of these domains for one of your projects, as the \"request specific domains\" form on the web does. Each entry may be a domain or a URL; it is read as its full domain, lowercased. Repeated domains are requested once, and a domain already requested changes nothing. Up to 200 distinct domains per call. They then appear in the project's catalogue with `project.requested` true (`requested=true` on GET /projects/{id}/medias) once Growwer lists them.
+    # @param id [String] The project.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param request_medias_request [RequestMediasRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [RequestMedias201Response]
+    def request_medias(id, idempotency_key, request_medias_request, opts = {})
+      data, _status_code, _headers = request_medias_with_http_info(id, idempotency_key, request_medias_request, opts)
+      data
+    end
+
+    # Request specific medias for a project
+    # Asks Growwer to find the medias of these domains for one of your projects, as the \&quot;request specific domains\&quot; form on the web does. Each entry may be a domain or a URL; it is read as its full domain, lowercased. Repeated domains are requested once, and a domain already requested changes nothing. Up to 200 distinct domains per call. They then appear in the project&#39;s catalogue with &#x60;project.requested&#x60; true (&#x60;requested&#x3D;true&#x60; on GET /projects/{id}/medias) once Growwer lists them.
+    # @param id [String] The project.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param request_medias_request [RequestMediasRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RequestMedias201Response, Integer, Hash)>] RequestMedias201Response data, response status code and response headers
+    def request_medias_with_http_info(id, idempotency_key, request_medias_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.request_medias ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.request_medias"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling CatalogueApi.request_medias"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling CatalogueApi.request_medias, the character length must be smaller than or equal to 255.'
+      end
+
+      # verify the required parameter 'request_medias_request' is set
+      if @api_client.config.client_side_validation && request_medias_request.nil?
+        fail ArgumentError, "Missing the required parameter 'request_medias_request' when calling CatalogueApi.request_medias"
+      end
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/media-requests'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(request_medias_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RequestMedias201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.request_medias",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#request_medias\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search the catalogue for a project
+    # The medias the catalogue offers for one of your projects, as the web lists them, with each media's state in the project. Filter with the parameters below, which all combine, or apply one of your saved filters with `savedFilterId` alone. The catalogue is open to accounts with recent completed orders (see `catalogue.eligible` on GET /me), and each account can see a limited number of distinct medias per day (UTC) across the catalogue operations; medias seen again the same day are free.
+    # @param id [String] The project.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :source Which of the project&#39;s medias to search: &#x60;all&#x60; (the default), &#x60;recommended&#x60; (those Growwer recommends for the project), or those you marked &#x60;favourite&#x60;, &#x60;discarded&#x60; or &#x60;requested&#x60;, or &#x60;bought&#x60; for the project. Do not combine it with the parameter of the same state.
+    # @option opts [String] :sort The order. Without it, the web&#39;s default order: medias on the project&#39;s topic and language first, then best sellers and medias with more published orders. Ties are always broken by media id, so pages never overlap. &#x60;-growwerRank&#x60;: best match first; &#x60;postPrice&#x60;, &#x60;linkAdditionPrice&#x60;: cheapest first; &#x60;matchedAt&#x60;, &#x60;-matchedAt&#x60;: when Growwer matched the media with the project; &#x60;-traffic&#x60;, &#x60;-domainRating&#x60;, &#x60;-referringDomains&#x60;: highest first; &#x60;linkedToReferringRatio&#x60;: lowest first.
+    # @option opts [String] :saved_filter_id Apply one of your saved filters of this project, including one saved on the web, instead of the other parameters. Do not combine it with any filter, &#x60;source&#x60; or &#x60;sort&#x60;. A filter saved on the web that uses a filter the API does not support is refused with 422 &#x60;saved_filter_unsupported&#x60;.
+    # @option opts [String] :domain Medias whose domain contains this text, 1 to 255 characters.
+    # @option opts [String] :website_type A comma-separated list of website types: &#x60;blog&#x60;, &#x60;press&#x60;.
+    # @option opts [String] :language A comma-separated list of language codes, as in GET /vocabulary.
+    # @option opts [String] :country A comma-separated list of country codes, as in GET /vocabulary.
+    # @option opts [String] :topics A comma-separated list of topic ids, as in GET /vocabulary: medias on any of them.
+    # @option opts [Boolean] :not_banned_topics Leave out medias that refuse the topic of the project. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_traffic Minimum monthly organic traffic.
+    # @option opts [Integer] :max_traffic Maximum monthly organic traffic.
+    # @option opts [Boolean] :traffic_trend_upward Medias whose traffic is growing. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_domain_rating Minimum domain rating, 0 to 100.
+    # @option opts [Integer] :max_domain_rating Maximum domain rating, 0 to 100.
+    # @option opts [Float] :min_linked_to_referring_ratio Minimum ratio of linked domains to referring domains, such as 0.5.
+    # @option opts [Float] :max_linked_to_referring_ratio Maximum ratio of linked domains to referring domains, such as 1.5.
+    # @option opts [Integer] :min_post_price Minimum post price, in cents.
+    # @option opts [Integer] :max_post_price Maximum post price, in cents.
+    # @option opts [String] :post_link_type A comma-separated list of link types the post offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [String] :promoted_social_network A comma-separated list of social networks the media promotes posts on: &#x60;twitter&#x60;, &#x60;instagram&#x60;, &#x60;facebook&#x60;, &#x60;pinterest&#x60;, &#x60;tumblr&#x60;, &#x60;newsletter&#x60;.
+    # @option opts [Boolean] :without_advertising_label Medias that never label posts as advertising. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :homepage_listing Medias that offer listing the post on their homepage. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :has_link_addition Medias that offer adding a link to an existing article. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_link_addition_price Minimum link addition price, in cents.
+    # @option opts [Integer] :max_link_addition_price Maximum link addition price, in cents.
+    # @option opts [String] :link_addition_link_type A comma-separated list of link types the link addition offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [Boolean] :recommended &#x60;true&#x60;: only the medias Growwer recommends for the project; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :favourite &#x60;true&#x60;: only your favourites for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :requested &#x60;true&#x60;: only the medias you requested for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :flash_offer &#x60;true&#x60;: only medias with a flash offer running; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :bought &#x60;true&#x60;: only medias you bought for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :discarded &#x60;true&#x60;: only the medias you discarded for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :new Medias Growwer matched with the project recently. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [String] :ranks_goal_keyword A comma-separated list of keyword origins: medias that rank for a keyword of the project from any of them. &#x60;user&#x60;: your keywords; &#x60;publicGenerated&#x60;: keywords Growwer found for the project.
+    # @option opts [String] :ranks_ai_keyword A comma-separated list of AI answer engines: medias cited for a keyword of the project by any of them. &#x60;googleAiOverview&#x60;, &#x60;chatgpt&#x60;, &#x60;googleAiMode&#x60;.
+    # @option opts [Integer] :limit Medias per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Medias to skip, at most 99900. (default to 0)
+    # @return [ListFlashOffers200Response]
+    def search_project_medias(id, opts = {})
+      data, _status_code, _headers = search_project_medias_with_http_info(id, opts)
+      data
+    end
+
+    # Search the catalogue for a project
+    # The medias the catalogue offers for one of your projects, as the web lists them, with each media&#39;s state in the project. Filter with the parameters below, which all combine, or apply one of your saved filters with &#x60;savedFilterId&#x60; alone. The catalogue is open to accounts with recent completed orders (see &#x60;catalogue.eligible&#x60; on GET /me), and each account can see a limited number of distinct medias per day (UTC) across the catalogue operations; medias seen again the same day are free.
+    # @param id [String] The project.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :source Which of the project&#39;s medias to search: &#x60;all&#x60; (the default), &#x60;recommended&#x60; (those Growwer recommends for the project), or those you marked &#x60;favourite&#x60;, &#x60;discarded&#x60; or &#x60;requested&#x60;, or &#x60;bought&#x60; for the project. Do not combine it with the parameter of the same state.
+    # @option opts [String] :sort The order. Without it, the web&#39;s default order: medias on the project&#39;s topic and language first, then best sellers and medias with more published orders. Ties are always broken by media id, so pages never overlap. &#x60;-growwerRank&#x60;: best match first; &#x60;postPrice&#x60;, &#x60;linkAdditionPrice&#x60;: cheapest first; &#x60;matchedAt&#x60;, &#x60;-matchedAt&#x60;: when Growwer matched the media with the project; &#x60;-traffic&#x60;, &#x60;-domainRating&#x60;, &#x60;-referringDomains&#x60;: highest first; &#x60;linkedToReferringRatio&#x60;: lowest first.
+    # @option opts [String] :saved_filter_id Apply one of your saved filters of this project, including one saved on the web, instead of the other parameters. Do not combine it with any filter, &#x60;source&#x60; or &#x60;sort&#x60;. A filter saved on the web that uses a filter the API does not support is refused with 422 &#x60;saved_filter_unsupported&#x60;.
+    # @option opts [String] :domain Medias whose domain contains this text, 1 to 255 characters.
+    # @option opts [String] :website_type A comma-separated list of website types: &#x60;blog&#x60;, &#x60;press&#x60;.
+    # @option opts [String] :language A comma-separated list of language codes, as in GET /vocabulary.
+    # @option opts [String] :country A comma-separated list of country codes, as in GET /vocabulary.
+    # @option opts [String] :topics A comma-separated list of topic ids, as in GET /vocabulary: medias on any of them.
+    # @option opts [Boolean] :not_banned_topics Leave out medias that refuse the topic of the project. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_traffic Minimum monthly organic traffic.
+    # @option opts [Integer] :max_traffic Maximum monthly organic traffic.
+    # @option opts [Boolean] :traffic_trend_upward Medias whose traffic is growing. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_domain_rating Minimum domain rating, 0 to 100.
+    # @option opts [Integer] :max_domain_rating Maximum domain rating, 0 to 100.
+    # @option opts [Float] :min_linked_to_referring_ratio Minimum ratio of linked domains to referring domains, such as 0.5.
+    # @option opts [Float] :max_linked_to_referring_ratio Maximum ratio of linked domains to referring domains, such as 1.5.
+    # @option opts [Integer] :min_post_price Minimum post price, in cents.
+    # @option opts [Integer] :max_post_price Maximum post price, in cents.
+    # @option opts [String] :post_link_type A comma-separated list of link types the post offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [String] :promoted_social_network A comma-separated list of social networks the media promotes posts on: &#x60;twitter&#x60;, &#x60;instagram&#x60;, &#x60;facebook&#x60;, &#x60;pinterest&#x60;, &#x60;tumblr&#x60;, &#x60;newsletter&#x60;.
+    # @option opts [Boolean] :without_advertising_label Medias that never label posts as advertising. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :homepage_listing Medias that offer listing the post on their homepage. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Boolean] :has_link_addition Medias that offer adding a link to an existing article. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [Integer] :min_link_addition_price Minimum link addition price, in cents.
+    # @option opts [Integer] :max_link_addition_price Maximum link addition price, in cents.
+    # @option opts [String] :link_addition_link_type A comma-separated list of link types the link addition offer gives: &#x60;dofollow&#x60;, &#x60;nofollow&#x60;, &#x60;citation&#x60;.
+    # @option opts [Boolean] :recommended &#x60;true&#x60;: only the medias Growwer recommends for the project; &#x60;false&#x60;: only the others.
+    # @option opts [Boolean] :favourite &#x60;true&#x60;: only your favourites for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :requested &#x60;true&#x60;: only the medias you requested for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :flash_offer &#x60;true&#x60;: only medias with a flash offer running; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :bought &#x60;true&#x60;: only medias you bought for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :discarded &#x60;true&#x60;: only the medias you discarded for the project; &#x60;false&#x60;: leave them out.
+    # @option opts [Boolean] :new Medias Growwer matched with the project recently. Only &#x60;true&#x60; applies it; omit it otherwise.
+    # @option opts [String] :ranks_goal_keyword A comma-separated list of keyword origins: medias that rank for a keyword of the project from any of them. &#x60;user&#x60;: your keywords; &#x60;publicGenerated&#x60;: keywords Growwer found for the project.
+    # @option opts [String] :ranks_ai_keyword A comma-separated list of AI answer engines: medias cited for a keyword of the project by any of them. &#x60;googleAiOverview&#x60;, &#x60;chatgpt&#x60;, &#x60;googleAiMode&#x60;.
+    # @option opts [Integer] :limit Medias per page, 1 to 100. (default to 20)
+    # @option opts [Integer] :offset Medias to skip, at most 99900. (default to 0)
+    # @return [Array<(ListFlashOffers200Response, Integer, Hash)>] ListFlashOffers200Response data, response status code and response headers
+    def search_project_medias_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.search_project_medias ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.search_project_medias"
+      end
+      allowable_values = ["all", "recommended", "favourite", "discarded", "requested", "bought"]
+      if @api_client.config.client_side_validation && opts[:'source'] && !allowable_values.include?(opts[:'source'])
+        fail ArgumentError, "invalid value for \"source\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["-growwerRank", "postPrice", "linkAdditionPrice", "matchedAt", "-matchedAt", "-traffic", "-domainRating", "linkedToReferringRatio", "-referringDomains"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CatalogueApi.search_project_medias, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CatalogueApi.search_project_medias, must be greater than or equal to 1.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] > 99900
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling CatalogueApi.search_project_medias, must be smaller than or equal to 99900.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling CatalogueApi.search_project_medias, must be greater than or equal to 0.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/medias'.sub('{id}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'savedFilterId'] = opts[:'saved_filter_id'] if !opts[:'saved_filter_id'].nil?
+      query_params[:'domain'] = opts[:'domain'] if !opts[:'domain'].nil?
+      query_params[:'websiteType'] = opts[:'website_type'] if !opts[:'website_type'].nil?
+      query_params[:'language'] = opts[:'language'] if !opts[:'language'].nil?
+      query_params[:'country'] = opts[:'country'] if !opts[:'country'].nil?
+      query_params[:'topics'] = opts[:'topics'] if !opts[:'topics'].nil?
+      query_params[:'notBannedTopics'] = opts[:'not_banned_topics'] if !opts[:'not_banned_topics'].nil?
+      query_params[:'minTraffic'] = opts[:'min_traffic'] if !opts[:'min_traffic'].nil?
+      query_params[:'maxTraffic'] = opts[:'max_traffic'] if !opts[:'max_traffic'].nil?
+      query_params[:'trafficTrendUpward'] = opts[:'traffic_trend_upward'] if !opts[:'traffic_trend_upward'].nil?
+      query_params[:'minDomainRating'] = opts[:'min_domain_rating'] if !opts[:'min_domain_rating'].nil?
+      query_params[:'maxDomainRating'] = opts[:'max_domain_rating'] if !opts[:'max_domain_rating'].nil?
+      query_params[:'minLinkedToReferringRatio'] = opts[:'min_linked_to_referring_ratio'] if !opts[:'min_linked_to_referring_ratio'].nil?
+      query_params[:'maxLinkedToReferringRatio'] = opts[:'max_linked_to_referring_ratio'] if !opts[:'max_linked_to_referring_ratio'].nil?
+      query_params[:'minPostPrice'] = opts[:'min_post_price'] if !opts[:'min_post_price'].nil?
+      query_params[:'maxPostPrice'] = opts[:'max_post_price'] if !opts[:'max_post_price'].nil?
+      query_params[:'postLinkType'] = opts[:'post_link_type'] if !opts[:'post_link_type'].nil?
+      query_params[:'promotedSocialNetwork'] = opts[:'promoted_social_network'] if !opts[:'promoted_social_network'].nil?
+      query_params[:'withoutAdvertisingLabel'] = opts[:'without_advertising_label'] if !opts[:'without_advertising_label'].nil?
+      query_params[:'homepageListing'] = opts[:'homepage_listing'] if !opts[:'homepage_listing'].nil?
+      query_params[:'hasLinkAddition'] = opts[:'has_link_addition'] if !opts[:'has_link_addition'].nil?
+      query_params[:'minLinkAdditionPrice'] = opts[:'min_link_addition_price'] if !opts[:'min_link_addition_price'].nil?
+      query_params[:'maxLinkAdditionPrice'] = opts[:'max_link_addition_price'] if !opts[:'max_link_addition_price'].nil?
+      query_params[:'linkAdditionLinkType'] = opts[:'link_addition_link_type'] if !opts[:'link_addition_link_type'].nil?
+      query_params[:'recommended'] = opts[:'recommended'] if !opts[:'recommended'].nil?
+      query_params[:'favourite'] = opts[:'favourite'] if !opts[:'favourite'].nil?
+      query_params[:'requested'] = opts[:'requested'] if !opts[:'requested'].nil?
+      query_params[:'flashOffer'] = opts[:'flash_offer'] if !opts[:'flash_offer'].nil?
+      query_params[:'bought'] = opts[:'bought'] if !opts[:'bought'].nil?
+      query_params[:'discarded'] = opts[:'discarded'] if !opts[:'discarded'].nil?
+      query_params[:'new'] = opts[:'new'] if !opts[:'new'].nil?
+      query_params[:'ranksGoalKeyword'] = opts[:'ranks_goal_keyword'] if !opts[:'ranks_goal_keyword'].nil?
+      query_params[:'ranksAiKeyword'] = opts[:'ranks_ai_keyword'] if !opts[:'ranks_ai_keyword'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListFlashOffers200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.search_project_medias",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#search_project_medias\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Restore a discarded media for a project
+    # Restores a media you discarded for one of your projects. Restoring one that is not discarded changes nothing. It works for any media, even one the catalogue no longer shows.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def undiscard_media(id, media_id, idempotency_key, opts = {})
+      undiscard_media_with_http_info(id, media_id, idempotency_key, opts)
+      nil
+    end
+
+    # Restore a discarded media for a project
+    # Restores a media you discarded for one of your projects. Restoring one that is not discarded changes nothing. It works for any media, even one the catalogue no longer shows.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def undiscard_media_with_http_info(id, media_id, idempotency_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.undiscard_media ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.undiscard_media"
+      end
+      # verify the required parameter 'media_id' is set
+      if @api_client.config.client_side_validation && media_id.nil?
+        fail ArgumentError, "Missing the required parameter 'media_id' when calling CatalogueApi.undiscard_media"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling CatalogueApi.undiscard_media"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling CatalogueApi.undiscard_media, the character length must be smaller than or equal to 255.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/discards/{mediaId}'.sub('{id}', CGI.escape(id.to_s)).sub('{mediaId}', CGI.escape(media_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.undiscard_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#undiscard_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Remove a media from the favourites of a project
+    # Removes a media from the favourites of one of your projects. Removing one that is not a favourite changes nothing. It works for any media, even one the catalogue no longer shows.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def unfavourite_media(id, media_id, idempotency_key, opts = {})
+      unfavourite_media_with_http_info(id, media_id, idempotency_key, opts)
+      nil
+    end
+
+    # Remove a media from the favourites of a project
+    # Removes a media from the favourites of one of your projects. Removing one that is not a favourite changes nothing. It works for any media, even one the catalogue no longer shows.
+    # @param id [String] The project.
+    # @param media_id [String] The media.
+    # @param idempotency_key [String] A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (&#x60;!&#x60; to &#x60;~&#x60;); any other value answers 400 &#x60;invalid_idempotency_key&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def unfavourite_media_with_http_info(id, media_id, idempotency_key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CatalogueApi.unfavourite_media ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling CatalogueApi.unfavourite_media"
+      end
+      # verify the required parameter 'media_id' is set
+      if @api_client.config.client_side_validation && media_id.nil?
+        fail ArgumentError, "Missing the required parameter 'media_id' when calling CatalogueApi.unfavourite_media"
+      end
+      # verify the required parameter 'idempotency_key' is set
+      if @api_client.config.client_side_validation && idempotency_key.nil?
+        fail ArgumentError, "Missing the required parameter 'idempotency_key' when calling CatalogueApi.unfavourite_media"
+      end
+      if @api_client.config.client_side_validation && idempotency_key.to_s.length > 255
+        fail ArgumentError, 'invalid value for "idempotency_key" when calling CatalogueApi.unfavourite_media, the character length must be smaller than or equal to 255.'
+      end
+
+      # resource path
+      local_var_path = '/api/v1/projects/{id}/favourites/{mediaId}'.sub('{id}', CGI.escape(id.to_s)).sub('{mediaId}', CGI.escape(media_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'Idempotency-Key'] = idempotency_key
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['apiKey']
+
+      new_options = opts.merge(
+        :operation => :"CatalogueApi.unfavourite_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CatalogueApi#unfavourite_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end