late-sdk 0.0.926 → 0.0.928

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

@@ -15,15 +15,18 @@ require 'time'
 
 module Zernio
   class UpdateAdRequest < ApiModelBase
-    # Google RSA only. Replaces the complete headline list. No padding or truncation on update.
+    # Google Search and Display only. Replaces the complete headline list. Search takes 3-15, Display 1-5 and rejects pinnedField; the count is checked once the ad's channel is known. No padding or truncation on update.
     attr_accessor :headlines
 
-    # Google RSA only. Replaces the complete description list. No padding or truncation on update.
+    # Google Search and Display only. Replaces the complete description list. Search takes 2-4, Display 1-5 and rejects pinnedField. No padding or truncation on update.
     attr_accessor :descriptions
 
-    # Google RSA only. Replaces final URLs. Omitted lists stay unchanged.
+    # Google Search and Display only. Replaces final URLs. Omitted lists stay unchanged. For Performance Max use assetGroup.finalUrl.
     attr_accessor :final_urls
 
+    # Google Performance Max only. Replaces whole asset roles on the ad's asset group. Returns 422 on any other platform or channel.
+    attr_accessor :asset_group
+
     attr_accessor :status
 
     attr_accessor :budget
@@ -63,6 +66,7 @@ module Zernio
         :'headlines' => :'headlines',
         :'descriptions' => :'descriptions',
         :'final_urls' => :'finalUrls',
+        :'asset_group' => :'assetGroup',
         :'status' => :'status',
         :'budget' => :'budget',
         :'targeting' => :'targeting',
@@ -87,6 +91,7 @@ module Zernio
         :'headlines' => :'Array<GoogleRsaHeadline>',
         :'descriptions' => :'Array<GoogleRsaDescription>',
         :'final_urls' => :'Array<String>',
+        :'asset_group' => :'GooglePmaxAssetGroupUpdate',
         :'status' => :'String',
         :'budget' => :'UpdateAdRequestBudget',
         :'targeting' => :'UpdateAdRequestTargeting',
@@ -135,6 +140,10 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'asset_group')
+        self.asset_group = attributes[:'asset_group']
+      end
+
       if attributes.key?(:'status')
         self.status = attributes[:'status']
       end
@@ -165,16 +174,16 @@ module Zernio
         invalid_properties.push('invalid value for "headlines", number of items must be less than or equal to 15.')
       end
 
-      if !@headlines.nil? && @headlines.length < 3
-        invalid_properties.push('invalid value for "headlines", number of items must be greater than or equal to 3.')
+      if !@headlines.nil? && @headlines.length < 1
+        invalid_properties.push('invalid value for "headlines", number of items must be greater than or equal to 1.')
       end
 
-      if !@descriptions.nil? && @descriptions.length > 4
-        invalid_properties.push('invalid value for "descriptions", number of items must be less than or equal to 4.')
+      if !@descriptions.nil? && @descriptions.length > 5
+        invalid_properties.push('invalid value for "descriptions", number of items must be less than or equal to 5.')
       end
 
-      if !@descriptions.nil? && @descriptions.length < 2
-        invalid_properties.push('invalid value for "descriptions", number of items must be greater than or equal to 2.')
+      if !@descriptions.nil? && @descriptions.length < 1
+        invalid_properties.push('invalid value for "descriptions", number of items must be greater than or equal to 1.')
       end
 
       if !@final_urls.nil? && @final_urls.length < 1
@@ -193,9 +202,9 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if !@headlines.nil? && @headlines.length > 15
-      return false if !@headlines.nil? && @headlines.length < 3
-      return false if !@descriptions.nil? && @descriptions.length > 4
-      return false if !@descriptions.nil? && @descriptions.length < 2
+      return false if !@headlines.nil? && @headlines.length < 1
+      return false if !@descriptions.nil? && @descriptions.length > 5
+      return false if !@descriptions.nil? && @descriptions.length < 1
       return false if !@final_urls.nil? && @final_urls.length < 1
       status_validator = EnumAttributeValidator.new('String', ["active", "paused"])
       return false unless status_validator.valid?(@status)
@@ -214,8 +223,8 @@ module Zernio
         fail ArgumentError, 'invalid value for "headlines", number of items must be less than or equal to 15.'
       end
 
-      if headlines.length < 3
-        fail ArgumentError, 'invalid value for "headlines", number of items must be greater than or equal to 3.'
+      if headlines.length < 1
+        fail ArgumentError, 'invalid value for "headlines", number of items must be greater than or equal to 1.'
       end
 
       @headlines = headlines
@@ -228,12 +237,12 @@ module Zernio
         fail ArgumentError, 'descriptions cannot be nil'
       end
 
-      if descriptions.length > 4
-        fail ArgumentError, 'invalid value for "descriptions", number of items must be less than or equal to 4.'
+      if descriptions.length > 5
+        fail ArgumentError, 'invalid value for "descriptions", number of items must be less than or equal to 5.'
       end
 
-      if descriptions.length < 2
-        fail ArgumentError, 'invalid value for "descriptions", number of items must be greater than or equal to 2.'
+      if descriptions.length < 1
+        fail ArgumentError, 'invalid value for "descriptions", number of items must be greater than or equal to 1.'
       end
 
       @descriptions = descriptions
@@ -285,6 +294,7 @@ module Zernio
           headlines == o.headlines &&
           descriptions == o.descriptions &&
           final_urls == o.final_urls &&
+          asset_group == o.asset_group &&
           status == o.status &&
           budget == o.budget &&
           targeting == o.targeting &&
@@ -301,7 +311,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [headlines, descriptions, final_urls, status, budget, targeting, creative, name].hash
+      [headlines, descriptions, final_urls, asset_group, status, budget, targeting, creative, name].hash
     end
 
     # Builds the object from hash

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

@@ -24,6 +24,15 @@ module Zernio
     # Meta and LinkedIn (TikTok has no headline slot)
     attr_accessor :headline
 
+    # Google Display only. Replaces the responsive display ad's long headline.
+    attr_accessor :long_headline
+
+    # Google Display only. Replaces the responsive display ad's business name.
+    attr_accessor :business_name
+
+    # Google Display only. Uploaded as a new square (1:1) marketing image asset that replaces the current one.
+    attr_accessor :square_image_url
+
     attr_accessor :body
 
     # Link description slot (Meta `link_data.description` / `video_data.link_description`, LinkedIn creative description).
@@ -71,6 +80,9 @@ module Zernio
         :'promotion' => :'promotion',
         :'creative_features' => :'creativeFeatures',
         :'headline' => :'headline',
+        :'long_headline' => :'longHeadline',
+        :'business_name' => :'businessName',
+        :'square_image_url' => :'squareImageUrl',
         :'body' => :'body',
         :'description' => :'description',
         :'call_to_action' => :'callToAction',
@@ -98,6 +110,9 @@ module Zernio
         :'promotion' => :'MetaPromotion',
         :'creative_features' => :'Hash<String, String>',
         :'headline' => :'String',
+        :'long_headline' => :'String',
+        :'business_name' => :'String',
+        :'square_image_url' => :'String',
         :'body' => :'String',
         :'description' => :'String',
         :'call_to_action' => :'String',
@@ -145,6 +160,18 @@ module Zernio
         self.headline = attributes[:'headline']
       end
 
+      if attributes.key?(:'long_headline')
+        self.long_headline = attributes[:'long_headline']
+      end
+
+      if attributes.key?(:'business_name')
+        self.business_name = attributes[:'business_name']
+      end
+
+      if attributes.key?(:'square_image_url')
+        self.square_image_url = attributes[:'square_image_url']
+      end
+
       if attributes.key?(:'body')
         self.body = attributes[:'body']
       end
@@ -183,6 +210,22 @@ module Zernio
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      if !@long_headline.nil? && @long_headline.to_s.length > 90
+        invalid_properties.push('invalid value for "long_headline", the character length must be smaller than or equal to 90.')
+      end
+
+      if !@long_headline.nil? && @long_headline.to_s.length < 1
+        invalid_properties.push('invalid value for "long_headline", the character length must be greater than or equal to 1.')
+      end
+
+      if !@business_name.nil? && @business_name.to_s.length > 25
+        invalid_properties.push('invalid value for "business_name", the character length must be smaller than or equal to 25.')
+      end
+
+      if !@business_name.nil? && @business_name.to_s.length < 1
+        invalid_properties.push('invalid value for "business_name", the character length must be greater than or equal to 1.')
+      end
+
       if !@description.nil? && @description.to_s.length > 255
         invalid_properties.push('invalid value for "description", the character length must be smaller than or equal to 255.')
       end
@@ -194,10 +237,50 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if !@long_headline.nil? && @long_headline.to_s.length > 90
+      return false if !@long_headline.nil? && @long_headline.to_s.length < 1
+      return false if !@business_name.nil? && @business_name.to_s.length > 25
+      return false if !@business_name.nil? && @business_name.to_s.length < 1
       return false if !@description.nil? && @description.to_s.length > 255
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] long_headline Value to be assigned
+    def long_headline=(long_headline)
+      if long_headline.nil?
+        fail ArgumentError, 'long_headline cannot be nil'
+      end
+
+      if long_headline.to_s.length > 90
+        fail ArgumentError, 'invalid value for "long_headline", the character length must be smaller than or equal to 90.'
+      end
+
+      if long_headline.to_s.length < 1
+        fail ArgumentError, 'invalid value for "long_headline", the character length must be greater than or equal to 1.'
+      end
+
+      @long_headline = long_headline
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] business_name Value to be assigned
+    def business_name=(business_name)
+      if business_name.nil?
+        fail ArgumentError, 'business_name cannot be nil'
+      end
+
+      if business_name.to_s.length > 25
+        fail ArgumentError, 'invalid value for "business_name", the character length must be smaller than or equal to 25.'
+      end
+
+      if business_name.to_s.length < 1
+        fail ArgumentError, 'invalid value for "business_name", the character length must be greater than or equal to 1.'
+      end
+
+      @business_name = business_name
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] description Value to be assigned
     def description=(description)
@@ -220,6 +303,9 @@ module Zernio
           promotion == o.promotion &&
           creative_features == o.creative_features &&
           headline == o.headline &&
+          long_headline == o.long_headline &&
+          business_name == o.business_name &&
+          square_image_url == o.square_image_url &&
           body == o.body &&
           description == o.description &&
           call_to_action == o.call_to_action &&
@@ -239,7 +325,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [promotion, creative_features, headline, body, description, call_to_action, link_url, image_url, video_url, video_id, existing_creative_id].hash
+      [promotion, creative_features, headline, long_headline, business_name, square_image_url, body, description, call_to_action, link_url, image_url, video_url, video_id, existing_creative_id].hash
     end
 
     # Builds the object from hash

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

@@ -29,8 +29,14 @@ module Zernio
 
     attr_accessor :age_max
 
+    # ISO 3166-1 alpha-2 codes. On Google this is the FULL new country set for the campaign (same contract as `locations`); on LinkedIn it replaces the campaign's geo criteria.
     attr_accessor :countries
 
+    attr_accessor :locations
+
+    # Google only. The FULL new language set for the campaign, as Google language codes (ISO 639-1, plus variants such as `zh_CN`). An unknown code returns 400.
+    attr_accessor :languages
+
     # Interest objects from /v1/ads/interests. Each must include id and name.
     attr_accessor :interests
 
@@ -68,6 +74,8 @@ module Zernio
         :'age_min' => :'ageMin',
         :'age_max' => :'ageMax',
         :'countries' => :'countries',
+        :'locations' => :'locations',
+        :'languages' => :'languages',
         :'interests' => :'interests',
         :'advantage_audience' => :'advantage_audience'
       }
@@ -92,6 +100,8 @@ module Zernio
         :'age_min' => :'Integer',
         :'age_max' => :'Integer',
         :'countries' => :'Array<String>',
+        :'locations' => :'UpdateAdRequestTargetingLocations',
+        :'languages' => :'Array<String>',
         :'interests' => :'Array<UpdateAdRequestTargetingInterestsInner>',
         :'advantage_audience' => :'Integer'
       }
@@ -151,6 +161,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'locations')
+        self.locations = attributes[:'locations']
+      end
+
+      if attributes.key?(:'languages')
+        if (value = attributes[:'languages']).is_a?(Array)
+          self.languages = value
+        end
+      end
+
       if attributes.key?(:'interests')
         if (value = attributes[:'interests']).is_a?(Array)
           self.interests = value
@@ -256,6 +276,8 @@ module Zernio
           age_min == o.age_min &&
           age_max == o.age_max &&
           countries == o.countries &&
+          locations == o.locations &&
+          languages == o.languages &&
           interests == o.interests &&
           advantage_audience == o.advantage_audience
     end
@@ -269,7 +291,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [keywords, negative_keywords, devices, age_min, age_max, countries, interests, advantage_audience].hash
+      [keywords, negative_keywords, devices, age_min, age_max, countries, locations, languages, interests, advantage_audience].hash
     end
 
     # Builds the object from hash

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

@@ -0,0 +1,105 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+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
+  # Google and LinkedIn. The FULL new location set for the campaign. Bare country-code array, or an object with countries/regions/cities/zips/metros key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Equivalent to the top-level geo fields; sending both returns 400. Empty returns 400, `customLocations` returns 422.
+  module UpdateAdRequestTargetingLocations
+    class << self
+      # List of class defined in oneOf (OpenAPI v3)
+      def openapi_one_of
+        [
+          :'Array<String>',
+          :'UpdateCampaignTargetingRequestTargetingLocationsOneOf'
+        ]
+      end
+
+      # Builds the object
+      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @return [Object] Returns the model or the data itself
+      def build(data)
+        # Go through the list of oneOf items and attempt to identify the appropriate one.
+        # Note:
+        # - We do not attempt to check whether exactly one item matches.
+        # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+        #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+        # - TODO: scalar values are de facto behaving as if they were nullable.
+        # - TODO: logging when debugging is set.
+        openapi_one_of.each do |klass|
+          begin
+            next if klass == :AnyType # "nullable: true"
+            return find_and_cast_into_type(klass, data)
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+        end
+
+        openapi_one_of.include?(:AnyType) ? data : nil
+      end
+
+      private
+
+      SchemaMismatchError = Class.new(StandardError)
+
+      # Note: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+      def find_and_cast_into_type(klass, data)
+        return if data.nil?
+
+        case klass.to_s
+        when 'Boolean'
+          return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+        when 'Float'
+          return data if data.instance_of?(Float)
+        when 'Integer'
+          return data if data.instance_of?(Integer)
+        when 'Time'
+          return Time.parse(data)
+        when 'Date'
+          return Date.iso8601(data)
+        when 'String'
+          return data if data.instance_of?(String)
+        when 'Object' # "type: object"
+          return data if data.instance_of?(Hash)
+        when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+          if data.instance_of?(Array)
+            sub_type = Regexp.last_match[:sub_type]
+            return data.map { |item| find_and_cast_into_type(sub_type, item) }
+          end
+        when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+          if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+            sub_type = Regexp.last_match[:sub_type]
+            return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+          end
+        else # model
+          const = Zernio.const_get(klass)
+          if const
+            if const.respond_to?(:openapi_one_of) # nested oneOf model
+              model = const.build(data)
+              return model if model
+            else
+              # raise if data contains keys that are not known to the model
+              raise if const.respond_to?(:acceptable_attributes) && !(data.keys - const.acceptable_attributes).empty?
+              model = const.build_from_hash(data)
+              return model if model
+            end
+          end
+        end
+
+        raise # if no match by now, raise
+      rescue
+        raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
+      end
+    end
+  end
+
+end

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.926'
+  VERSION = '0.0.928'
 end

data/lib/zernio-sdk.rb

@@ -936,6 +936,8 @@ require 'zernio-sdk/models/google_pmax_asset_group'
 require 'zernio-sdk/models/google_pmax_asset_group_assets_inner'
 require 'zernio-sdk/models/google_pmax_asset_group_input'
 require 'zernio-sdk/models/google_pmax_asset_group_input_images'
+require 'zernio-sdk/models/google_pmax_asset_group_update'
+require 'zernio-sdk/models/google_pmax_asset_group_update_images'
 require 'zernio-sdk/models/google_rsa_description'
 require 'zernio-sdk/models/google_rsa_headline'
 require 'zernio-sdk/models/google_sitelink'
@@ -1671,6 +1673,7 @@ require 'zernio-sdk/models/update_ad_request_targeting_devices_inner_one_of'
 require 'zernio-sdk/models/update_ad_request_targeting_interests_inner'
 require 'zernio-sdk/models/update_ad_request_targeting_keywords_inner'
 require 'zernio-sdk/models/update_ad_request_targeting_keywords_inner_one_of'
+require 'zernio-sdk/models/update_ad_request_targeting_locations'
 require 'zernio-sdk/models/update_ad_set200_response'
 require 'zernio-sdk/models/update_ad_set_request'
 require 'zernio-sdk/models/update_ad_set_request_budget'