zernio-sdk 0.0.550 → 0.0.552

data/lib/zernio-sdk/api/tracking_tags_api.rb

@@ -173,6 +173,69 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Get ad tracking tags
+    # Unified read of the platform's native click-URL tracking params. - Meta (facebook/instagram): the creative's `url_tags` (and template_url_spec). - Google (googleads): the campaign's `trackingUrlTemplate` + `finalUrlSuffix`.   Subject to the Google Ads API access-tier daily quota; bulk audits need Standard access. - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`. Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest). 
+    # @param ad_id [String] Ad id (hex _id, platformAdId, or effective story/media id).
+    # @param [Hash] opts the optional parameters
+    # @return [GetAdTrackingTags200Response]
+    def get_ad_tracking_tags(ad_id, opts = {})
+      data, _status_code, _headers = get_ad_tracking_tags_with_http_info(ad_id, opts)
+      data
+    end
+
+    # Get ad tracking tags
+    # Unified read of the platform's native click-URL tracking params. - Meta (facebook/instagram): the creative's `url_tags` (and template_url_spec). - Google (googleads): the campaign's `trackingUrlTemplate` + `finalUrlSuffix`.   Subject to the Google Ads API access-tier daily quota; bulk audits need Standard access. - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`. Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest). 
+    # @param ad_id [String] Ad id (hex _id, platformAdId, or effective story/media id).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetAdTrackingTags200Response, Integer, Hash)>] GetAdTrackingTags200Response data, response status code and response headers
+    def get_ad_tracking_tags_with_http_info(ad_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TrackingTagsApi.get_ad_tracking_tags ...'
+      end
+      # verify the required parameter 'ad_id' is set
+      if @api_client.config.client_side_validation && ad_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_id' when calling TrackingTagsApi.get_ad_tracking_tags"
+      end
+      # resource path
+      local_var_path = '/v1/ads/{adId}/tracking-tags'.sub('{' + 'adId' + '}', CGI.escape(ad_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] || 'GetAdTrackingTags200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"TrackingTagsApi.get_ad_tracking_tags",
+        :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: TrackingTagsApi#get_ad_tracking_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get a tracking tag
     # Returns the full tag record including the base-code `code` snippet, `lastFiredTime`, `ownerBusinessId`, `isUnavailable`, etc. Meta only (platform `metaads`); other platforms return 405. 
     # @param account_id [String] 
@@ -531,6 +594,80 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Set ad tracking tags
+    # Unified update. Send only the fields for the ad's platform: - Meta: `urlTags` (array of {key,value}). Meta creatives are immutable, so this rebuilds the   creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim   (re-post its object_story_spec + the new url_tags, reusing the image), so you send `urlTags`   ALONE — no need to read back headline/body/CTA. `creative` (headline, body, callToAction,   linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post   / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for   `creative`). - Google: `trackingUrlTemplate` and/or `finalUrlSuffix` (full template strings; account quota applies). - LinkedIn: `dynamicValueParameters` and/or `customValueParameters` (campaign-level Dynamic UTM). 
+    # @param ad_id [String] 
+    # @param update_ad_tracking_tags_request [UpdateAdTrackingTagsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def update_ad_tracking_tags(ad_id, update_ad_tracking_tags_request, opts = {})
+      update_ad_tracking_tags_with_http_info(ad_id, update_ad_tracking_tags_request, opts)
+      nil
+    end
+
+    # Set ad tracking tags
+    # Unified update. Send only the fields for the ad&#39;s platform: - Meta: &#x60;urlTags&#x60; (array of {key,value}). Meta creatives are immutable, so this rebuilds the   creative and repoints the ad. By DEFAULT we PRESERVE the existing creative verbatim   (re-post its object_story_spec + the new url_tags, reusing the image), so you send &#x60;urlTags&#x60;   ALONE — no need to read back headline/body/CTA. &#x60;creative&#x60; (headline, body, callToAction,   linkUrl, imageUrl) is OPTIONAL and only needed to rebuild explicitly, or for SHARE / page-post   / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for   &#x60;creative&#x60;). - Google: &#x60;trackingUrlTemplate&#x60; and/or &#x60;finalUrlSuffix&#x60; (full template strings; account quota applies). - LinkedIn: &#x60;dynamicValueParameters&#x60; and/or &#x60;customValueParameters&#x60; (campaign-level Dynamic UTM). 
+    # @param ad_id [String] 
+    # @param update_ad_tracking_tags_request [UpdateAdTrackingTagsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def update_ad_tracking_tags_with_http_info(ad_id, update_ad_tracking_tags_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TrackingTagsApi.update_ad_tracking_tags ...'
+      end
+      # verify the required parameter 'ad_id' is set
+      if @api_client.config.client_side_validation && ad_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_id' when calling TrackingTagsApi.update_ad_tracking_tags"
+      end
+      # verify the required parameter 'update_ad_tracking_tags_request' is set
+      if @api_client.config.client_side_validation && update_ad_tracking_tags_request.nil?
+        fail ArgumentError, "Missing the required parameter 'update_ad_tracking_tags_request' when calling TrackingTagsApi.update_ad_tracking_tags"
+      end
+      # resource path
+      local_var_path = '/v1/ads/{adId}/tracking-tags'.sub('{' + 'adId' + '}', CGI.escape(ad_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
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_ad_tracking_tags_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"TrackingTagsApi.update_ad_tracking_tags",
+        :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(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TrackingTagsApi#update_ad_tracking_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update a tracking tag
     # Partial-update a pixel. Whitelisted fields: `name` (rename), `enableAutomaticMatching`, `automaticMatchingFields`, `firstPartyCookieStatus`, `dataUseSetting`. At least one is required. Returns the re-fetched canonical tag. Meta only (platform `metaads`); other platforms return 405.  There is no DELETE — Meta has no API to delete a pixel. To stop using one, unshare it from your ad accounts (`DELETE .../tracking-tags/{tagId}/shared-accounts`) or disable it in Events Manager. 
     # @param account_id [String] 

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

@@ -18,6 +18,7 @@ module Zernio
   class BoostPostRequestTracking < ApiModelBase
     attr_accessor :pixel_id
 
+    # URL parameters appended to the ad link, rendered as `key=value` pairs joined with `&`.
     attr_accessor :url_tags
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -42,7 +43,7 @@ module Zernio
     def self.openapi_types
       {
         :'pixel_id' => :'String',
-        :'url_tags' => :'String'
+        :'url_tags' => :'Array<BoostPostRequestTrackingUrlTagsInner>'
       }
     end
 
@@ -73,7 +74,9 @@ module Zernio
       end
 
       if attributes.key?(:'url_tags')
-        self.url_tags = attributes[:'url_tags']
+        if (value = attributes[:'url_tags']).is_a?(Array)
+          self.url_tags = value
+        end
       end
     end
 

data/lib/zernio-sdk/models/{create_lead_form_request_questions_inner_options_inner.rb → boost_post_request_tracking_url_tags_inner.rb}

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  class CreateLeadFormRequestQuestionsInnerOptionsInner < ApiModelBase
+  class BoostPostRequestTrackingUrlTagsInner < ApiModelBase
     attr_accessor :key
 
     attr_accessor :value
@@ -55,14 +55,14 @@ module Zernio
     # @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::CreateLeadFormRequestQuestionsInnerOptionsInner` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::BoostPostRequestTrackingUrlTagsInner` 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::CreateLeadFormRequestQuestionsInnerOptionsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::BoostPostRequestTrackingUrlTagsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }

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

@@ -55,7 +55,7 @@ module Zernio
         :'type' => :'String',
         :'key' => :'String',
         :'label' => :'String',
-        :'options' => :'Array<CreateLeadFormRequestQuestionsInnerOptionsInner>',
+        :'options' => :'Array<BoostPostRequestTrackingUrlTagsInner>',
         :'inline_context' => :'String'
       }
     end

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

@@ -25,6 +25,9 @@ module Zernio
 
     attr_accessor :date_range
 
+    # Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube.
+    attr_accessor :provisional_since
+
     # Sum of views across all days in the range
     attr_accessor :total_views
 
@@ -42,6 +45,7 @@ module Zernio
         :'video_id' => :'videoId',
         :'duration_seconds' => :'durationSeconds',
         :'date_range' => :'dateRange',
+        :'provisional_since' => :'provisionalSince',
         :'total_views' => :'totalViews',
         :'daily_views' => :'dailyViews',
         :'last_synced_at' => :'lastSyncedAt',
@@ -66,6 +70,7 @@ module Zernio
         :'video_id' => :'String',
         :'duration_seconds' => :'Integer',
         :'date_range' => :'YouTubeDailyViewsResponseDateRange',
+        :'provisional_since' => :'Date',
         :'total_views' => :'Integer',
         :'daily_views' => :'Array<YouTubeDailyViewsResponseDailyViewsInner>',
         :'last_synced_at' => :'Time',
@@ -113,6 +118,10 @@ module Zernio
         self.date_range = attributes[:'date_range']
       end
 
+      if attributes.key?(:'provisional_since')
+        self.provisional_since = attributes[:'provisional_since']
+      end
+
       if attributes.key?(:'total_views')
         self.total_views = attributes[:'total_views']
       end
@@ -156,6 +165,7 @@ module Zernio
           video_id == o.video_id &&
           duration_seconds == o.duration_seconds &&
           date_range == o.date_range &&
+          provisional_since == o.provisional_since &&
           total_views == o.total_views &&
           daily_views == o.daily_views &&
           last_synced_at == o.last_synced_at &&
@@ -171,7 +181,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [success, video_id, duration_seconds, date_range, total_views, daily_views, last_synced_at, scope_status].hash
+      [success, video_id, duration_seconds, date_range, provisional_since, total_views, daily_views, last_synced_at, scope_status].hash
     end
 
     # Builds the object from hash

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

@@ -36,6 +36,9 @@ module Zernio
 
     attr_accessor :date_range
 
+    # Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube.
+    attr_accessor :provisional_since
+
     attr_accessor :note
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -49,6 +52,7 @@ module Zernio
         :'published_at' => :'publishedAt',
         :'demographics' => :'demographics',
         :'date_range' => :'dateRange',
+        :'provisional_since' => :'provisionalSince',
         :'note' => :'note'
       }
     end
@@ -74,6 +78,7 @@ module Zernio
         :'published_at' => :'Time',
         :'demographics' => :'Hash<String, Array<YouTubeDemographicsResponseDemographicsValueInner>>',
         :'date_range' => :'YouTubeDemographicsResponseDateRange',
+        :'provisional_since' => :'Date',
         :'note' => :'String'
       }
     end
@@ -136,6 +141,10 @@ module Zernio
         self.date_range = attributes[:'date_range']
       end
 
+      if attributes.key?(:'provisional_since')
+        self.provisional_since = attributes[:'provisional_since']
+      end
+
       if attributes.key?(:'note')
         self.note = attributes[:'note']
       end
@@ -169,6 +178,7 @@ module Zernio
           published_at == o.published_at &&
           demographics == o.demographics &&
           date_range == o.date_range &&
+          provisional_since == o.provisional_since &&
           note == o.note
     end
 
@@ -181,7 +191,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [success, account_id, platform, video_id, title, published_at, demographics, date_range, note].hash
+      [success, account_id, platform, video_id, title, published_at, demographics, date_range, provisional_since, note].hash
     end
 
     # Builds the object from hash

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

@@ -34,6 +34,9 @@ module Zernio
 
     attr_accessor :date_range
 
+    # Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube.
+    attr_accessor :provisional_since
+
     # Up to 100 points covering the video timeline, aggregated over the date range. Empty for videos with very few views.
     attr_accessor :retention_curve
 
@@ -52,6 +55,7 @@ module Zernio
         :'published_at' => :'publishedAt',
         :'duration_seconds' => :'durationSeconds',
         :'date_range' => :'dateRange',
+        :'provisional_since' => :'provisionalSince',
         :'retention_curve' => :'retentionCurve',
         :'note' => :'note',
         :'scope_status' => :'scopeStatus'
@@ -78,6 +82,7 @@ module Zernio
         :'published_at' => :'Time',
         :'duration_seconds' => :'Integer',
         :'date_range' => :'YouTubeDailyViewsResponseDateRange',
+        :'provisional_since' => :'Date',
         :'retention_curve' => :'Array<YouTubeVideoRetentionResponseRetentionCurveInner>',
         :'note' => :'String',
         :'scope_status' => :'YouTubeDailyViewsResponseScopeStatus'
@@ -137,6 +142,10 @@ module Zernio
         self.date_range = attributes[:'date_range']
       end
 
+      if attributes.key?(:'provisional_since')
+        self.provisional_since = attributes[:'provisional_since']
+      end
+
       if attributes.key?(:'retention_curve')
         if (value = attributes[:'retention_curve']).is_a?(Array)
           self.retention_curve = value
@@ -179,6 +188,7 @@ module Zernio
           published_at == o.published_at &&
           duration_seconds == o.duration_seconds &&
           date_range == o.date_range &&
+          provisional_since == o.provisional_since &&
           retention_curve == o.retention_curve &&
           note == o.note &&
           scope_status == o.scope_status
@@ -193,7 +203,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [success, account_id, video_id, title, published_at, duration_seconds, date_range, retention_curve, note, scope_status].hash
+      [success, account_id, video_id, title, published_at, duration_seconds, date_range, provisional_since, retention_curve, note, scope_status].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -103,6 +103,7 @@ require 'zernio-sdk/models/boost_post_request_targeting_cities_inner'
 require 'zernio-sdk/models/boost_post_request_targeting_custom_locations_inner'
 require 'zernio-sdk/models/boost_post_request_targeting_regions_inner'
 require 'zernio-sdk/models/boost_post_request_tracking'
+require 'zernio-sdk/models/boost_post_request_tracking_url_tags_inner'
 require 'zernio-sdk/models/bulk_create_contacts200_response'
 require 'zernio-sdk/models/bulk_create_contacts_request'
 require 'zernio-sdk/models/bulk_create_contacts_request_contacts_inner'
@@ -214,7 +215,6 @@ require 'zernio-sdk/models/create_invite_token_request'
 require 'zernio-sdk/models/create_lead_form200_response'
 require 'zernio-sdk/models/create_lead_form_request'
 require 'zernio-sdk/models/create_lead_form_request_questions_inner'
-require 'zernio-sdk/models/create_lead_form_request_questions_inner_options_inner'
 require 'zernio-sdk/models/create_messaging_ad_request'
 require 'zernio-sdk/models/create_phone_number_kyc_link200_response'
 require 'zernio-sdk/models/create_phone_number_kyc_link_request'
@@ -1510,9 +1510,12 @@ require 'zernio-sdk/api/api_keys_api'
 require 'zernio-sdk/api/account_groups_api'
 require 'zernio-sdk/api/account_settings_api'
 require 'zernio-sdk/api/accounts_api'
+require 'zernio-sdk/api/ad_accounts_api'
 require 'zernio-sdk/api/ad_audiences_api'
 require 'zernio-sdk/api/ad_campaigns_api'
-require 'zernio-sdk/api/ads_api'
+require 'zernio-sdk/api/ad_creatives_api'
+require 'zernio-sdk/api/ad_insights_api'
+require 'zernio-sdk/api/ad_targeting_api'
 require 'zernio-sdk/api/analytics_api'
 require 'zernio-sdk/api/broadcasts_api'
 require 'zernio-sdk/api/calls_api'
@@ -1520,6 +1523,7 @@ require 'zernio-sdk/api/comment_automations_api'
 require 'zernio-sdk/api/comments_api'
 require 'zernio-sdk/api/connect_api'
 require 'zernio-sdk/api/contacts_api'
+require 'zernio-sdk/api/conversions_api'
 require 'zernio-sdk/api/custom_fields_api'
 require 'zernio-sdk/api/discord_api'
 require 'zernio-sdk/api/gmb_attributes_api'
@@ -1533,15 +1537,18 @@ require 'zernio-sdk/api/gmb_verifications_api'
 require 'zernio-sdk/api/inbox_analytics_api'
 require 'zernio-sdk/api/instagram_api'
 require 'zernio-sdk/api/invites_api'
+require 'zernio-sdk/api/lead_gen_api'
 require 'zernio-sdk/api/linked_in_mentions_api'
 require 'zernio-sdk/api/logs_api'
 require 'zernio-sdk/api/media_api'
 require 'zernio-sdk/api/mentions_api'
 require 'zernio-sdk/api/messages_api'
+require 'zernio-sdk/api/messaging_ads_api'
 require 'zernio-sdk/api/phone_numbers_api'
 require 'zernio-sdk/api/posts_api'
 require 'zernio-sdk/api/profiles_api'
 require 'zernio-sdk/api/queue_api'
+require 'zernio-sdk/api/reach_and_frequency_api'
 require 'zernio-sdk/api/reddit_search_api'
 require 'zernio-sdk/api/reviews_api'
 require 'zernio-sdk/api/sms_api'