late-sdk 0.0.528 → 0.0.530

data/lib/zernio-sdk/models/create_call_ad_request.rb

@@ -0,0 +1,869 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class CreateCallAdRequest < ApiModelBase
+    # Facebook or Instagram SocialAccount ID.
+    attr_accessor :account_id
+
+    # Meta ad account ID, e.g. `act_123456789`.
+    attr_accessor :ad_account_id
+
+    # Ad display name. Used to derive campaign / ad set names. On the multi-creative shape, each ad's Meta name gets a \" #N\" suffix (1-indexed) so Ads Manager shows them as a numbered batch. 
+    attr_accessor :name
+
+    # Single-creative shape only. Mutually exclusive with `creatives[]`. 
+    attr_accessor :headline
+
+    # Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`. 
+    attr_accessor :body
+
+    # Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied. 
+    attr_accessor :image_url
+
+    attr_accessor :video
+
+    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
+    attr_accessor :creatives
+
+    # Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. 
+    attr_accessor :budget_amount
+
+    attr_accessor :budget_type
+
+    # ISO 4217 currency code matching the ad account's currency (e.g. `USD`). Optional; Meta infers from the ad account when omitted. 
+    attr_accessor :currency
+
+    # ISO 8601 datetime. Required when `budgetType` is `lifetime`. 
+    attr_accessor :end_date
+
+    # ISO 3166-1 alpha-2 country codes. Defaults to `[\"US\"]` only when no other geo (`cities`, `regions`, `zips`, `metros`, `customLocations`) is supplied. 
+    attr_accessor :countries
+
+    # City-level geo targeting for local CTWA campaigns. Each entry maps to Meta's TargetingGeoLocationCity. `key` is Meta's city ID. `radius` and `distance_unit` are coupled: set both or neither. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng). 
+    attr_accessor :cities
+
+    # Region / state-level geo targeting. `key` is Meta's region ID (lookupable via GET /v1/ads/targeting/search?type=region). 
+    attr_accessor :regions
+
+    # ZIP / postal-code geo targeting. `key` is the platform's postal id resolved via /v1/ads/targeting/search. 
+    attr_accessor :zips
+
+    # DMA / metro-area geo targeting. `key` is Meta's metro id (e.g. `DMA:807`). 
+    attr_accessor :metros
+
+    # Point-radius geo (Meta `geo_locations.custom_locations`). Use for targeting a radius around a specific lat/long when no Meta city/region key fits. `distanceUnit` is required. 
+    attr_accessor :custom_locations
+
+    attr_accessor :age_min
+
+    attr_accessor :age_max
+
+    attr_accessor :interests
+
+    # Custom audience ID to target.
+    attr_accessor :audience_id
+
+    attr_accessor :placements
+
+    # Meta's Advantage+ audience expansion. `0` (default) keeps targeting strict; `1` lets Meta expand beyond the supplied targeting when its delivery system finds better matches. Always sent on CREATE (Meta requires it). 
+    attr_accessor :advantage_audience
+
+    # Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require additional account configuration (Dataset linked to the WABA for sales) and may be rejected by Meta if missing. 
+    attr_accessor :objective
+
+    # Meta bid strategy applied to the shared ad set. Defaults to `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted. `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires `roasAverageFloor`. CTWA's `optimization_goal` is fixed to `CONVERSATIONS`, but the bid strategy is independent. 
+    attr_accessor :bid_strategy
+
+    # Whole currency units (e.g. `5` = $5.00 on a USD account). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`; rejected otherwise. 
+    attr_accessor :bid_amount
+
+    # Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side. 
+    attr_accessor :roas_average_floor
+
+    # Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted. 
+    attr_accessor :dsa_beneficiary
+
+    # Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor. 
+    attr_accessor :dsa_payor
+
+    # E.164 number the CALL_NOW CTA dials (e.g. +34600111222).
+    attr_accessor :phone_number
+
+    # Website shown as the creative's link. Required: Meta rejects tel: as link_data.link; the phone number rides only the CTA.
+    attr_accessor :link_url
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'account_id' => :'accountId',
+        :'ad_account_id' => :'adAccountId',
+        :'name' => :'name',
+        :'headline' => :'headline',
+        :'body' => :'body',
+        :'image_url' => :'imageUrl',
+        :'video' => :'video',
+        :'creatives' => :'creatives',
+        :'budget_amount' => :'budgetAmount',
+        :'budget_type' => :'budgetType',
+        :'currency' => :'currency',
+        :'end_date' => :'endDate',
+        :'countries' => :'countries',
+        :'cities' => :'cities',
+        :'regions' => :'regions',
+        :'zips' => :'zips',
+        :'metros' => :'metros',
+        :'custom_locations' => :'customLocations',
+        :'age_min' => :'ageMin',
+        :'age_max' => :'ageMax',
+        :'interests' => :'interests',
+        :'audience_id' => :'audienceId',
+        :'placements' => :'placements',
+        :'advantage_audience' => :'advantageAudience',
+        :'objective' => :'objective',
+        :'bid_strategy' => :'bidStrategy',
+        :'bid_amount' => :'bidAmount',
+        :'roas_average_floor' => :'roasAverageFloor',
+        :'dsa_beneficiary' => :'dsaBeneficiary',
+        :'dsa_payor' => :'dsaPayor',
+        :'phone_number' => :'phoneNumber',
+        :'link_url' => :'linkUrl'
+      }
+    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
+      {
+        :'account_id' => :'String',
+        :'ad_account_id' => :'String',
+        :'name' => :'String',
+        :'headline' => :'String',
+        :'body' => :'String',
+        :'image_url' => :'String',
+        :'video' => :'CtwaAdRequestBodyVideo',
+        :'creatives' => :'Array<CtwaAdRequestBodyCreativesInner>',
+        :'budget_amount' => :'Float',
+        :'budget_type' => :'String',
+        :'currency' => :'String',
+        :'end_date' => :'Time',
+        :'countries' => :'Array<String>',
+        :'cities' => :'Array<CtwaAdRequestBodyCitiesInner>',
+        :'regions' => :'Array<CtwaAdRequestBodyRegionsInner>',
+        :'zips' => :'Array<CtwaAdRequestBodyZipsInner>',
+        :'metros' => :'Array<CtwaAdRequestBodyZipsInner>',
+        :'custom_locations' => :'Array<CreateStandaloneAdRequestCustomLocationsInner>',
+        :'age_min' => :'Integer',
+        :'age_max' => :'Integer',
+        :'interests' => :'Array<CreateStandaloneAdRequestBehaviorsInner>',
+        :'audience_id' => :'String',
+        :'placements' => :'CtwaAdRequestBodyPlacements',
+        :'advantage_audience' => :'Integer',
+        :'objective' => :'String',
+        :'bid_strategy' => :'String',
+        :'bid_amount' => :'Float',
+        :'roas_average_floor' => :'Float',
+        :'dsa_beneficiary' => :'String',
+        :'dsa_payor' => :'String',
+        :'phone_number' => :'String',
+        :'link_url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # List of class defined in allOf (OpenAPI v3)
+    def self.openapi_all_of
+      [
+      :'CtwaAdRequestBody'
+      ]
+    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 `Zernio::CreateCallAdRequest` 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 `Zernio::CreateCallAdRequest`. 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?(:'account_id')
+        self.account_id = attributes[:'account_id']
+      else
+        self.account_id = nil
+      end
+
+      if attributes.key?(:'ad_account_id')
+        self.ad_account_id = attributes[:'ad_account_id']
+      else
+        self.ad_account_id = nil
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      else
+        self.name = nil
+      end
+
+      if attributes.key?(:'headline')
+        self.headline = attributes[:'headline']
+      end
+
+      if attributes.key?(:'body')
+        self.body = attributes[:'body']
+      end
+
+      if attributes.key?(:'image_url')
+        self.image_url = attributes[:'image_url']
+      end
+
+      if attributes.key?(:'video')
+        self.video = attributes[:'video']
+      end
+
+      if attributes.key?(:'creatives')
+        if (value = attributes[:'creatives']).is_a?(Array)
+          self.creatives = value
+        end
+      end
+
+      if attributes.key?(:'budget_amount')
+        self.budget_amount = attributes[:'budget_amount']
+      else
+        self.budget_amount = nil
+      end
+
+      if attributes.key?(:'budget_type')
+        self.budget_type = attributes[:'budget_type']
+      else
+        self.budget_type = nil
+      end
+
+      if attributes.key?(:'currency')
+        self.currency = attributes[:'currency']
+      end
+
+      if attributes.key?(:'end_date')
+        self.end_date = attributes[:'end_date']
+      end
+
+      if attributes.key?(:'countries')
+        if (value = attributes[:'countries']).is_a?(Array)
+          self.countries = value
+        end
+      end
+
+      if attributes.key?(:'cities')
+        if (value = attributes[:'cities']).is_a?(Array)
+          self.cities = value
+        end
+      end
+
+      if attributes.key?(:'regions')
+        if (value = attributes[:'regions']).is_a?(Array)
+          self.regions = value
+        end
+      end
+
+      if attributes.key?(:'zips')
+        if (value = attributes[:'zips']).is_a?(Array)
+          self.zips = value
+        end
+      end
+
+      if attributes.key?(:'metros')
+        if (value = attributes[:'metros']).is_a?(Array)
+          self.metros = value
+        end
+      end
+
+      if attributes.key?(:'custom_locations')
+        if (value = attributes[:'custom_locations']).is_a?(Array)
+          self.custom_locations = value
+        end
+      end
+
+      if attributes.key?(:'age_min')
+        self.age_min = attributes[:'age_min']
+      end
+
+      if attributes.key?(:'age_max')
+        self.age_max = attributes[:'age_max']
+      end
+
+      if attributes.key?(:'interests')
+        if (value = attributes[:'interests']).is_a?(Array)
+          self.interests = value
+        end
+      end
+
+      if attributes.key?(:'audience_id')
+        self.audience_id = attributes[:'audience_id']
+      end
+
+      if attributes.key?(:'placements')
+        self.placements = attributes[:'placements']
+      end
+
+      if attributes.key?(:'advantage_audience')
+        self.advantage_audience = attributes[:'advantage_audience']
+      end
+
+      if attributes.key?(:'objective')
+        self.objective = attributes[:'objective']
+      end
+
+      if attributes.key?(:'bid_strategy')
+        self.bid_strategy = attributes[:'bid_strategy']
+      end
+
+      if attributes.key?(:'bid_amount')
+        self.bid_amount = attributes[:'bid_amount']
+      end
+
+      if attributes.key?(:'roas_average_floor')
+        self.roas_average_floor = attributes[:'roas_average_floor']
+      end
+
+      if attributes.key?(:'dsa_beneficiary')
+        self.dsa_beneficiary = attributes[:'dsa_beneficiary']
+      end
+
+      if attributes.key?(:'dsa_payor')
+        self.dsa_payor = attributes[:'dsa_payor']
+      end
+
+      if attributes.key?(:'phone_number')
+        self.phone_number = attributes[:'phone_number']
+      else
+        self.phone_number = nil
+      end
+
+      if attributes.key?(:'link_url')
+        self.link_url = attributes[:'link_url']
+      else
+        self.link_url = 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 @account_id.nil?
+        invalid_properties.push('invalid value for "account_id", account_id cannot be nil.')
+      end
+
+      if @account_id.to_s.length < 1
+        invalid_properties.push('invalid value for "account_id", the character length must be greater than or equal to 1.')
+      end
+
+      if @ad_account_id.nil?
+        invalid_properties.push('invalid value for "ad_account_id", ad_account_id cannot be nil.')
+      end
+
+      if @ad_account_id.to_s.length < 1
+        invalid_properties.push('invalid value for "ad_account_id", the character length must be greater than or equal to 1.')
+      end
+
+      if @name.nil?
+        invalid_properties.push('invalid value for "name", name cannot be nil.')
+      end
+
+      if @name.to_s.length < 1
+        invalid_properties.push('invalid value for "name", the character length must be greater than or equal to 1.')
+      end
+
+      if !@headline.nil? && @headline.to_s.length > 255
+        invalid_properties.push('invalid value for "headline", the character length must be smaller than or equal to 255.')
+      end
+
+      if !@headline.nil? && @headline.to_s.length < 1
+        invalid_properties.push('invalid value for "headline", the character length must be greater than or equal to 1.')
+      end
+
+      if !@body.nil? && @body.to_s.length < 1
+        invalid_properties.push('invalid value for "body", the character length must be greater than or equal to 1.')
+      end
+
+      if !@creatives.nil? && @creatives.length < 1
+        invalid_properties.push('invalid value for "creatives", number of items must be greater than or equal to 1.')
+      end
+
+      if @budget_amount.nil?
+        invalid_properties.push('invalid value for "budget_amount", budget_amount cannot be nil.')
+      end
+
+      if @budget_type.nil?
+        invalid_properties.push('invalid value for "budget_type", budget_type cannot be nil.')
+      end
+
+      if !@currency.nil? && @currency.to_s.length > 3
+        invalid_properties.push('invalid value for "currency", the character length must be smaller than or equal to 3.')
+      end
+
+      if !@currency.nil? && @currency.to_s.length < 3
+        invalid_properties.push('invalid value for "currency", the character length must be greater than or equal to 3.')
+      end
+
+      if !@age_min.nil? && @age_min > 65
+        invalid_properties.push('invalid value for "age_min", must be smaller than or equal to 65.')
+      end
+
+      if !@age_min.nil? && @age_min < 13
+        invalid_properties.push('invalid value for "age_min", must be greater than or equal to 13.')
+      end
+
+      if !@age_max.nil? && @age_max > 65
+        invalid_properties.push('invalid value for "age_max", must be smaller than or equal to 65.')
+      end
+
+      if !@age_max.nil? && @age_max < 13
+        invalid_properties.push('invalid value for "age_max", must be greater than or equal to 13.')
+      end
+
+      if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
+        invalid_properties.push('invalid value for "dsa_beneficiary", the character length must be smaller than or equal to 100.')
+      end
+
+      if !@dsa_payor.nil? && @dsa_payor.to_s.length > 100
+        invalid_properties.push('invalid value for "dsa_payor", the character length must be smaller than or equal to 100.')
+      end
+
+      if @phone_number.nil?
+        invalid_properties.push('invalid value for "phone_number", phone_number cannot be nil.')
+      end
+
+      if @link_url.nil?
+        invalid_properties.push('invalid value for "link_url", link_url 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 @account_id.nil?
+      return false if @account_id.to_s.length < 1
+      return false if @ad_account_id.nil?
+      return false if @ad_account_id.to_s.length < 1
+      return false if @name.nil?
+      return false if @name.to_s.length < 1
+      return false if !@headline.nil? && @headline.to_s.length > 255
+      return false if !@headline.nil? && @headline.to_s.length < 1
+      return false if !@body.nil? && @body.to_s.length < 1
+      return false if !@creatives.nil? && @creatives.length < 1
+      return false if @budget_amount.nil?
+      return false if @budget_type.nil?
+      budget_type_validator = EnumAttributeValidator.new('String', ["daily", "lifetime"])
+      return false unless budget_type_validator.valid?(@budget_type)
+      return false if !@currency.nil? && @currency.to_s.length > 3
+      return false if !@currency.nil? && @currency.to_s.length < 3
+      return false if !@age_min.nil? && @age_min > 65
+      return false if !@age_min.nil? && @age_min < 13
+      return false if !@age_max.nil? && @age_max > 65
+      return false if !@age_max.nil? && @age_max < 13
+      advantage_audience_validator = EnumAttributeValidator.new('Integer', [0, 1])
+      return false unless advantage_audience_validator.valid?(@advantage_audience)
+      objective_validator = EnumAttributeValidator.new('String', ["OUTCOME_ENGAGEMENT", "OUTCOME_SALES", "OUTCOME_LEADS"])
+      return false unless objective_validator.valid?(@objective)
+      bid_strategy_validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
+      return false unless bid_strategy_validator.valid?(@bid_strategy)
+      return false if !@dsa_beneficiary.nil? && @dsa_beneficiary.to_s.length > 100
+      return false if !@dsa_payor.nil? && @dsa_payor.to_s.length > 100
+      return false if @phone_number.nil?
+      return false if @link_url.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] account_id Value to be assigned
+    def account_id=(account_id)
+      if account_id.nil?
+        fail ArgumentError, 'account_id cannot be nil'
+      end
+
+      if account_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "account_id", the character length must be greater than or equal to 1.'
+      end
+
+      @account_id = account_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] ad_account_id Value to be assigned
+    def ad_account_id=(ad_account_id)
+      if ad_account_id.nil?
+        fail ArgumentError, 'ad_account_id cannot be nil'
+      end
+
+      if ad_account_id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "ad_account_id", the character length must be greater than or equal to 1.'
+      end
+
+      @ad_account_id = ad_account_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] name Value to be assigned
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'name cannot be nil'
+      end
+
+      if name.to_s.length < 1
+        fail ArgumentError, 'invalid value for "name", the character length must be greater than or equal to 1.'
+      end
+
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] headline Value to be assigned
+    def headline=(headline)
+      if headline.nil?
+        fail ArgumentError, 'headline cannot be nil'
+      end
+
+      if headline.to_s.length > 255
+        fail ArgumentError, 'invalid value for "headline", the character length must be smaller than or equal to 255.'
+      end
+
+      if headline.to_s.length < 1
+        fail ArgumentError, 'invalid value for "headline", the character length must be greater than or equal to 1.'
+      end
+
+      @headline = headline
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] body Value to be assigned
+    def body=(body)
+      if body.nil?
+        fail ArgumentError, 'body cannot be nil'
+      end
+
+      if body.to_s.length < 1
+        fail ArgumentError, 'invalid value for "body", the character length must be greater than or equal to 1.'
+      end
+
+      @body = body
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] creatives Value to be assigned
+    def creatives=(creatives)
+      if creatives.nil?
+        fail ArgumentError, 'creatives cannot be nil'
+      end
+
+      if creatives.length < 1
+        fail ArgumentError, 'invalid value for "creatives", number of items must be greater than or equal to 1.'
+      end
+
+      @creatives = creatives
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] budget_amount Value to be assigned
+    def budget_amount=(budget_amount)
+      if budget_amount.nil?
+        fail ArgumentError, 'budget_amount cannot be nil'
+      end
+
+      @budget_amount = budget_amount
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] budget_type Object to be assigned
+    def budget_type=(budget_type)
+      validator = EnumAttributeValidator.new('String', ["daily", "lifetime"])
+      unless validator.valid?(budget_type)
+        fail ArgumentError, "invalid value for \"budget_type\", must be one of #{validator.allowable_values}."
+      end
+      @budget_type = budget_type
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] currency Value to be assigned
+    def currency=(currency)
+      if currency.nil?
+        fail ArgumentError, 'currency cannot be nil'
+      end
+
+      if currency.to_s.length > 3
+        fail ArgumentError, 'invalid value for "currency", the character length must be smaller than or equal to 3.'
+      end
+
+      if currency.to_s.length < 3
+        fail ArgumentError, 'invalid value for "currency", the character length must be greater than or equal to 3.'
+      end
+
+      @currency = currency
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] age_min Value to be assigned
+    def age_min=(age_min)
+      if age_min.nil?
+        fail ArgumentError, 'age_min cannot be nil'
+      end
+
+      if age_min > 65
+        fail ArgumentError, 'invalid value for "age_min", must be smaller than or equal to 65.'
+      end
+
+      if age_min < 13
+        fail ArgumentError, 'invalid value for "age_min", must be greater than or equal to 13.'
+      end
+
+      @age_min = age_min
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] age_max Value to be assigned
+    def age_max=(age_max)
+      if age_max.nil?
+        fail ArgumentError, 'age_max cannot be nil'
+      end
+
+      if age_max > 65
+        fail ArgumentError, 'invalid value for "age_max", must be smaller than or equal to 65.'
+      end
+
+      if age_max < 13
+        fail ArgumentError, 'invalid value for "age_max", must be greater than or equal to 13.'
+      end
+
+      @age_max = age_max
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] advantage_audience Object to be assigned
+    def advantage_audience=(advantage_audience)
+      validator = EnumAttributeValidator.new('Integer', [0, 1])
+      unless validator.valid?(advantage_audience)
+        fail ArgumentError, "invalid value for \"advantage_audience\", must be one of #{validator.allowable_values}."
+      end
+      @advantage_audience = advantage_audience
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] objective Object to be assigned
+    def objective=(objective)
+      validator = EnumAttributeValidator.new('String', ["OUTCOME_ENGAGEMENT", "OUTCOME_SALES", "OUTCOME_LEADS"])
+      unless validator.valid?(objective)
+        fail ArgumentError, "invalid value for \"objective\", must be one of #{validator.allowable_values}."
+      end
+      @objective = objective
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] bid_strategy Object to be assigned
+    def bid_strategy=(bid_strategy)
+      validator = EnumAttributeValidator.new('String', ["LOWEST_COST_WITHOUT_CAP", "LOWEST_COST_WITH_BID_CAP", "COST_CAP", "LOWEST_COST_WITH_MIN_ROAS"])
+      unless validator.valid?(bid_strategy)
+        fail ArgumentError, "invalid value for \"bid_strategy\", must be one of #{validator.allowable_values}."
+      end
+      @bid_strategy = bid_strategy
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] dsa_beneficiary Value to be assigned
+    def dsa_beneficiary=(dsa_beneficiary)
+      if dsa_beneficiary.nil?
+        fail ArgumentError, 'dsa_beneficiary cannot be nil'
+      end
+
+      if dsa_beneficiary.to_s.length > 100
+        fail ArgumentError, 'invalid value for "dsa_beneficiary", the character length must be smaller than or equal to 100.'
+      end
+
+      @dsa_beneficiary = dsa_beneficiary
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] dsa_payor Value to be assigned
+    def dsa_payor=(dsa_payor)
+      if dsa_payor.nil?
+        fail ArgumentError, 'dsa_payor cannot be nil'
+      end
+
+      if dsa_payor.to_s.length > 100
+        fail ArgumentError, 'invalid value for "dsa_payor", the character length must be smaller than or equal to 100.'
+      end
+
+      @dsa_payor = dsa_payor
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] phone_number Value to be assigned
+    def phone_number=(phone_number)
+      if phone_number.nil?
+        fail ArgumentError, 'phone_number cannot be nil'
+      end
+
+      @phone_number = phone_number
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] link_url Value to be assigned
+    def link_url=(link_url)
+      if link_url.nil?
+        fail ArgumentError, 'link_url cannot be nil'
+      end
+
+      @link_url = link_url
+    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 &&
+          account_id == o.account_id &&
+          ad_account_id == o.ad_account_id &&
+          name == o.name &&
+          headline == o.headline &&
+          body == o.body &&
+          image_url == o.image_url &&
+          video == o.video &&
+          creatives == o.creatives &&
+          budget_amount == o.budget_amount &&
+          budget_type == o.budget_type &&
+          currency == o.currency &&
+          end_date == o.end_date &&
+          countries == o.countries &&
+          cities == o.cities &&
+          regions == o.regions &&
+          zips == o.zips &&
+          metros == o.metros &&
+          custom_locations == o.custom_locations &&
+          age_min == o.age_min &&
+          age_max == o.age_max &&
+          interests == o.interests &&
+          audience_id == o.audience_id &&
+          placements == o.placements &&
+          advantage_audience == o.advantage_audience &&
+          objective == o.objective &&
+          bid_strategy == o.bid_strategy &&
+          bid_amount == o.bid_amount &&
+          roas_average_floor == o.roas_average_floor &&
+          dsa_beneficiary == o.dsa_beneficiary &&
+          dsa_payor == o.dsa_payor &&
+          phone_number == o.phone_number &&
+          link_url == o.link_url
+    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
+      [account_id, ad_account_id, name, headline, body, image_url, video, creatives, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].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