mencoro 1.0.1 → 2.0.0

data/lib/mencoro/models/mention_sample_response.rb

@@ -0,0 +1,450 @@
+=begin
+#Mencoro API
+
+#Public API for Mencoro customers. Authenticate with an API key: `Authorization: Bearer mencoro_sk_...`. Every write operation requires an `Idempotency-Key` header: a retry carrying the same key and body within 30 days is answered from the stored result without running again; after 30 days the key is forgotten and a retry runs as a new operation.
+
+The version of the OpenAPI document: 1.0.0
+Contact: support@mencoro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.24.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Mencoro
+  class MentionSampleResponse < ApiModelBase
+    attr_accessor :id
+
+    attr_accessor :tracked_query_id
+
+    attr_accessor :ai_response_id
+
+    attr_accessor :engine
+
+    attr_accessor :competitor_id
+
+    attr_accessor :sentiment
+
+    attr_accessor :mention_type
+
+    attr_accessor :mention_position
+
+    attr_accessor :text
+
+    attr_accessor :detected_at
+
+    attr_accessor :query_text
+
+    attr_accessor :country
+
+    # Published because `competitorId` alone cannot answer the question. Own-brand AND untracked-competitor mentions both carry a null competitor id - the confusion migration Version20260608130000 was written to end - so a reader that treats a null competitor id as \"us\" silently counts a rival as the brand.
+    attr_accessor :mention_relation
+
+    attr_accessor :brand_name
+
+    attr_accessor :citations
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'id' => :'id',
+        :'tracked_query_id' => :'trackedQueryId',
+        :'ai_response_id' => :'aiResponseId',
+        :'engine' => :'engine',
+        :'competitor_id' => :'competitorId',
+        :'sentiment' => :'sentiment',
+        :'mention_type' => :'mentionType',
+        :'mention_position' => :'mentionPosition',
+        :'text' => :'text',
+        :'detected_at' => :'detectedAt',
+        :'query_text' => :'queryText',
+        :'country' => :'country',
+        :'mention_relation' => :'mentionRelation',
+        :'brand_name' => :'brandName',
+        :'citations' => :'citations'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'id' => :'String',
+        :'tracked_query_id' => :'String',
+        :'ai_response_id' => :'String',
+        :'engine' => :'String',
+        :'competitor_id' => :'String',
+        :'sentiment' => :'String',
+        :'mention_type' => :'String',
+        :'mention_position' => :'Integer',
+        :'text' => :'String',
+        :'detected_at' => :'String',
+        :'query_text' => :'String',
+        :'country' => :'String',
+        :'mention_relation' => :'String',
+        :'brand_name' => :'String',
+        :'citations' => :'Array<CitationResource>'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'competitor_id',
+        :'country',
+        :'mention_relation',
+        :'brand_name',
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Mencoro::MentionSampleResponse` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Mencoro::MentionSampleResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = nil
+      end
+
+      if attributes.key?(:'tracked_query_id')
+        self.tracked_query_id = attributes[:'tracked_query_id']
+      else
+        self.tracked_query_id = nil
+      end
+
+      if attributes.key?(:'ai_response_id')
+        self.ai_response_id = attributes[:'ai_response_id']
+      else
+        self.ai_response_id = nil
+      end
+
+      if attributes.key?(:'engine')
+        self.engine = attributes[:'engine']
+      else
+        self.engine = nil
+      end
+
+      if attributes.key?(:'competitor_id')
+        self.competitor_id = attributes[:'competitor_id']
+      end
+
+      if attributes.key?(:'sentiment')
+        self.sentiment = attributes[:'sentiment']
+      else
+        self.sentiment = nil
+      end
+
+      if attributes.key?(:'mention_type')
+        self.mention_type = attributes[:'mention_type']
+      else
+        self.mention_type = nil
+      end
+
+      if attributes.key?(:'mention_position')
+        self.mention_position = attributes[:'mention_position']
+      else
+        self.mention_position = nil
+      end
+
+      if attributes.key?(:'text')
+        self.text = attributes[:'text']
+      else
+        self.text = nil
+      end
+
+      if attributes.key?(:'detected_at')
+        self.detected_at = attributes[:'detected_at']
+      else
+        self.detected_at = nil
+      end
+
+      if attributes.key?(:'query_text')
+        self.query_text = attributes[:'query_text']
+      else
+        self.query_text = nil
+      end
+
+      if attributes.key?(:'country')
+        self.country = attributes[:'country']
+      end
+
+      if attributes.key?(:'mention_relation')
+        self.mention_relation = attributes[:'mention_relation']
+      end
+
+      if attributes.key?(:'brand_name')
+        self.brand_name = attributes[:'brand_name']
+      end
+
+      if attributes.key?(:'citations')
+        if (value = attributes[:'citations']).is_a?(Array)
+          self.citations = value
+        end
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @id.nil?
+        invalid_properties.push('invalid value for "id", id cannot be nil.')
+      end
+
+      if @tracked_query_id.nil?
+        invalid_properties.push('invalid value for "tracked_query_id", tracked_query_id cannot be nil.')
+      end
+
+      if @ai_response_id.nil?
+        invalid_properties.push('invalid value for "ai_response_id", ai_response_id cannot be nil.')
+      end
+
+      if @engine.nil?
+        invalid_properties.push('invalid value for "engine", engine cannot be nil.')
+      end
+
+      if @sentiment.nil?
+        invalid_properties.push('invalid value for "sentiment", sentiment cannot be nil.')
+      end
+
+      if @mention_type.nil?
+        invalid_properties.push('invalid value for "mention_type", mention_type cannot be nil.')
+      end
+
+      if @mention_position.nil?
+        invalid_properties.push('invalid value for "mention_position", mention_position cannot be nil.')
+      end
+
+      if @text.nil?
+        invalid_properties.push('invalid value for "text", text cannot be nil.')
+      end
+
+      if @detected_at.nil?
+        invalid_properties.push('invalid value for "detected_at", detected_at cannot be nil.')
+      end
+
+      if @query_text.nil?
+        invalid_properties.push('invalid value for "query_text", query_text cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @id.nil?
+      return false if @tracked_query_id.nil?
+      return false if @ai_response_id.nil?
+      return false if @engine.nil?
+      return false if @sentiment.nil?
+      return false if @mention_type.nil?
+      return false if @mention_position.nil?
+      return false if @text.nil?
+      return false if @detected_at.nil?
+      return false if @query_text.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] id Value to be assigned
+    def id=(id)
+      if id.nil?
+        fail ArgumentError, 'id cannot be nil'
+      end
+
+      @id = id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] tracked_query_id Value to be assigned
+    def tracked_query_id=(tracked_query_id)
+      if tracked_query_id.nil?
+        fail ArgumentError, 'tracked_query_id cannot be nil'
+      end
+
+      @tracked_query_id = tracked_query_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] ai_response_id Value to be assigned
+    def ai_response_id=(ai_response_id)
+      if ai_response_id.nil?
+        fail ArgumentError, 'ai_response_id cannot be nil'
+      end
+
+      @ai_response_id = ai_response_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] engine Value to be assigned
+    def engine=(engine)
+      if engine.nil?
+        fail ArgumentError, 'engine cannot be nil'
+      end
+
+      @engine = engine
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] sentiment Value to be assigned
+    def sentiment=(sentiment)
+      if sentiment.nil?
+        fail ArgumentError, 'sentiment cannot be nil'
+      end
+
+      @sentiment = sentiment
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] mention_type Value to be assigned
+    def mention_type=(mention_type)
+      if mention_type.nil?
+        fail ArgumentError, 'mention_type cannot be nil'
+      end
+
+      @mention_type = mention_type
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] mention_position Value to be assigned
+    def mention_position=(mention_position)
+      if mention_position.nil?
+        fail ArgumentError, 'mention_position cannot be nil'
+      end
+
+      @mention_position = mention_position
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] text Value to be assigned
+    def text=(text)
+      if text.nil?
+        fail ArgumentError, 'text cannot be nil'
+      end
+
+      @text = text
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] detected_at Value to be assigned
+    def detected_at=(detected_at)
+      if detected_at.nil?
+        fail ArgumentError, 'detected_at cannot be nil'
+      end
+
+      @detected_at = detected_at
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] query_text Value to be assigned
+    def query_text=(query_text)
+      if query_text.nil?
+        fail ArgumentError, 'query_text cannot be nil'
+      end
+
+      @query_text = query_text
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          id == o.id &&
+          tracked_query_id == o.tracked_query_id &&
+          ai_response_id == o.ai_response_id &&
+          engine == o.engine &&
+          competitor_id == o.competitor_id &&
+          sentiment == o.sentiment &&
+          mention_type == o.mention_type &&
+          mention_position == o.mention_position &&
+          text == o.text &&
+          detected_at == o.detected_at &&
+          query_text == o.query_text &&
+          country == o.country &&
+          mention_relation == o.mention_relation &&
+          brand_name == o.brand_name &&
+          citations == o.citations
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [id, tracked_query_id, ai_response_id, engine, competitor_id, sentiment, mention_type, mention_position, text, detected_at, query_text, country, mention_relation, brand_name, citations].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/mencoro/models/mention_type_counts.rb

@@ -0,0 +1,268 @@
+=begin
+#Mencoro API
+
+#Public API for Mencoro customers. Authenticate with an API key: `Authorization: Bearer mencoro_sk_...`. Every write operation requires an `Idempotency-Key` header: a retry carrying the same key and body within 30 days is answered from the stored result without running again; after 30 days the key is forgotten and a retry runs as a new operation.
+
+The version of the OpenAPI document: 1.0.0
+Contact: support@mencoro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.24.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Mencoro
+  class MentionTypeCounts < ApiModelBase
+    attr_accessor :recommendation
+
+    attr_accessor :comparison
+
+    attr_accessor :listing
+
+    attr_accessor :example
+
+    attr_accessor :reference
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'recommendation' => :'recommendation',
+        :'comparison' => :'comparison',
+        :'listing' => :'listing',
+        :'example' => :'example',
+        :'reference' => :'reference'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'recommendation' => :'Integer',
+        :'comparison' => :'Integer',
+        :'listing' => :'Integer',
+        :'example' => :'Integer',
+        :'reference' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Mencoro::MentionTypeCounts` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Mencoro::MentionTypeCounts`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'recommendation')
+        self.recommendation = attributes[:'recommendation']
+      else
+        self.recommendation = nil
+      end
+
+      if attributes.key?(:'comparison')
+        self.comparison = attributes[:'comparison']
+      else
+        self.comparison = nil
+      end
+
+      if attributes.key?(:'listing')
+        self.listing = attributes[:'listing']
+      else
+        self.listing = nil
+      end
+
+      if attributes.key?(:'example')
+        self.example = attributes[:'example']
+      else
+        self.example = nil
+      end
+
+      if attributes.key?(:'reference')
+        self.reference = attributes[:'reference']
+      else
+        self.reference = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @recommendation.nil?
+        invalid_properties.push('invalid value for "recommendation", recommendation cannot be nil.')
+      end
+
+      if @comparison.nil?
+        invalid_properties.push('invalid value for "comparison", comparison cannot be nil.')
+      end
+
+      if @listing.nil?
+        invalid_properties.push('invalid value for "listing", listing cannot be nil.')
+      end
+
+      if @example.nil?
+        invalid_properties.push('invalid value for "example", example cannot be nil.')
+      end
+
+      if @reference.nil?
+        invalid_properties.push('invalid value for "reference", reference cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @recommendation.nil?
+      return false if @comparison.nil?
+      return false if @listing.nil?
+      return false if @example.nil?
+      return false if @reference.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] recommendation Value to be assigned
+    def recommendation=(recommendation)
+      if recommendation.nil?
+        fail ArgumentError, 'recommendation cannot be nil'
+      end
+
+      @recommendation = recommendation
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] comparison Value to be assigned
+    def comparison=(comparison)
+      if comparison.nil?
+        fail ArgumentError, 'comparison cannot be nil'
+      end
+
+      @comparison = comparison
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] listing Value to be assigned
+    def listing=(listing)
+      if listing.nil?
+        fail ArgumentError, 'listing cannot be nil'
+      end
+
+      @listing = listing
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] example Value to be assigned
+    def example=(example)
+      if example.nil?
+        fail ArgumentError, 'example cannot be nil'
+      end
+
+      @example = example
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] reference Value to be assigned
+    def reference=(reference)
+      if reference.nil?
+        fail ArgumentError, 'reference cannot be nil'
+      end
+
+      @reference = reference
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          recommendation == o.recommendation &&
+          comparison == o.comparison &&
+          listing == o.listing &&
+          example == o.example &&
+          reference == o.reference
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [recommendation, comparison, listing, example, reference].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end