late-sdk 0.0.550 → 0.0.552

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

@@ -0,0 +1,404 @@
+=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 'cgi'
+
+module Zernio
+  class AdTargetingApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Estimate audience reach
+    # Returns a normalized pre-flight audience-size estimate for a targeting spec, before any campaign is created. Backed by each platform's native reach API (Meta `delivery_estimate`, LinkedIn `audienceCounts`, X `audience_summary`, Pinterest `audience_sizing`).  Platforms without a usable pre-flight reach API (Google Search/Display, TikTok) return `available: false` with no bounds, so clients can hide or grey out the estimate rather than treat the absence as an error. 
+    # @param estimate_ad_reach_request [EstimateAdReachRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [EstimateAdReach200Response]
+    def estimate_ad_reach(estimate_ad_reach_request, opts = {})
+      data, _status_code, _headers = estimate_ad_reach_with_http_info(estimate_ad_reach_request, opts)
+      data
+    end
+
+    # Estimate audience reach
+    # Returns a normalized pre-flight audience-size estimate for a targeting spec, before any campaign is created. Backed by each platform's native reach API (Meta `delivery_estimate`, LinkedIn `audienceCounts`, X `audience_summary`, Pinterest `audience_sizing`).  Platforms without a usable pre-flight reach API (Google Search/Display, TikTok) return `available: false` with no bounds, so clients can hide or grey out the estimate rather than treat the absence as an error. 
+    # @param estimate_ad_reach_request [EstimateAdReachRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(EstimateAdReach200Response, Integer, Hash)>] EstimateAdReach200Response data, response status code and response headers
+    def estimate_ad_reach_with_http_info(estimate_ad_reach_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdTargetingApi.estimate_ad_reach ...'
+      end
+      # verify the required parameter 'estimate_ad_reach_request' is set
+      if @api_client.config.client_side_validation && estimate_ad_reach_request.nil?
+        fail ArgumentError, "Missing the required parameter 'estimate_ad_reach_request' when calling AdTargetingApi.estimate_ad_reach"
+      end
+      # resource path
+      local_var_path = '/v1/ads/targeting/reach-estimate'
+
+      # 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(estimate_ad_reach_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EstimateAdReach200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdTargetingApi.estimate_ad_reach",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdTargetingApi#estimate_ad_reach\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Suggested bid and budget bounds
+    # LinkedIn-only. Returns the suggested bid and bid limits for a targeting spec, plus the daily-budget bounds LinkedIn will accept. Use it before creating a campaign to pick a bid inside the allowed range and warn the user if their daily budget is below the minimum. Wraps LinkedIn's `adBudgetPricing` finder.  Non-LinkedIn accounts return `available: false` so clients can hide the pricing UI without treating it as a failure. 
+    # @param get_linked_in_bid_pricing_request [GetLinkedInBidPricingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetLinkedInBidPricing200Response]
+    def get_linked_in_bid_pricing(get_linked_in_bid_pricing_request, opts = {})
+      data, _status_code, _headers = get_linked_in_bid_pricing_with_http_info(get_linked_in_bid_pricing_request, opts)
+      data
+    end
+
+    # Suggested bid and budget bounds
+    # LinkedIn-only. Returns the suggested bid and bid limits for a targeting spec, plus the daily-budget bounds LinkedIn will accept. Use it before creating a campaign to pick a bid inside the allowed range and warn the user if their daily budget is below the minimum. Wraps LinkedIn&#39;s &#x60;adBudgetPricing&#x60; finder.  Non-LinkedIn accounts return &#x60;available: false&#x60; so clients can hide the pricing UI without treating it as a failure. 
+    # @param get_linked_in_bid_pricing_request [GetLinkedInBidPricingRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetLinkedInBidPricing200Response, Integer, Hash)>] GetLinkedInBidPricing200Response data, response status code and response headers
+    def get_linked_in_bid_pricing_with_http_info(get_linked_in_bid_pricing_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdTargetingApi.get_linked_in_bid_pricing ...'
+      end
+      # verify the required parameter 'get_linked_in_bid_pricing_request' is set
+      if @api_client.config.client_side_validation && get_linked_in_bid_pricing_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_linked_in_bid_pricing_request' when calling AdTargetingApi.get_linked_in_bid_pricing"
+      end
+      # resource path
+      local_var_path = '/v1/ads/targeting/bid-pricing'
+
+      # 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(get_linked_in_bid_pricing_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetLinkedInBidPricing200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdTargetingApi.get_linked_in_bid_pricing",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdTargetingApi#get_linked_in_bid_pricing\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Impressions, clicks and spend forecast
+    # LinkedIn-only. Forecasted impressions, clicks, spend and ~20 other metrics for a targeting spec over a time range. Wraps LinkedIn's `adSupplyForecasts` finder.  Each returned series carries a `metricType` (IMPRESSION, CLICK, SPENDING, MAX_POTENTIAL_BUDGET, COST_PER_MILLION_IMPRESSIONS, ...) and a `granularity` (DAILY, SEVEN_DAY, THIRTY_DAY, CUSTOM). LinkedIn caps the daily spending forecast at 1.2x the daily budget and returns 0 once the total budget is exhausted.  Non-LinkedIn accounts return `available: false`. 
+    # @param get_linked_in_supply_forecast_request [GetLinkedInSupplyForecastRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [GetLinkedInSupplyForecast200Response]
+    def get_linked_in_supply_forecast(get_linked_in_supply_forecast_request, opts = {})
+      data, _status_code, _headers = get_linked_in_supply_forecast_with_http_info(get_linked_in_supply_forecast_request, opts)
+      data
+    end
+
+    # Impressions, clicks and spend forecast
+    # LinkedIn-only. Forecasted impressions, clicks, spend and ~20 other metrics for a targeting spec over a time range. Wraps LinkedIn&#39;s &#x60;adSupplyForecasts&#x60; finder.  Each returned series carries a &#x60;metricType&#x60; (IMPRESSION, CLICK, SPENDING, MAX_POTENTIAL_BUDGET, COST_PER_MILLION_IMPRESSIONS, ...) and a &#x60;granularity&#x60; (DAILY, SEVEN_DAY, THIRTY_DAY, CUSTOM). LinkedIn caps the daily spending forecast at 1.2x the daily budget and returns 0 once the total budget is exhausted.  Non-LinkedIn accounts return &#x60;available: false&#x60;. 
+    # @param get_linked_in_supply_forecast_request [GetLinkedInSupplyForecastRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetLinkedInSupplyForecast200Response, Integer, Hash)>] GetLinkedInSupplyForecast200Response data, response status code and response headers
+    def get_linked_in_supply_forecast_with_http_info(get_linked_in_supply_forecast_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdTargetingApi.get_linked_in_supply_forecast ...'
+      end
+      # verify the required parameter 'get_linked_in_supply_forecast_request' is set
+      if @api_client.config.client_side_validation && get_linked_in_supply_forecast_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_linked_in_supply_forecast_request' when calling AdTargetingApi.get_linked_in_supply_forecast"
+      end
+      # resource path
+      local_var_path = '/v1/ads/targeting/supply-forecast'
+
+      # 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(get_linked_in_supply_forecast_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetLinkedInSupplyForecast200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdTargetingApi.get_linked_in_supply_forecast",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdTargetingApi#get_linked_in_supply_forecast\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search targeting interests
+    # Deprecated alias for `GET /v1/ads/targeting/search?dimension=interest`. Kept for backward compatibility, it returns the legacy `{ interests: [...] }` shape rather than the normalized `{ results: [...] }`. New integrations should use `GET /v1/ads/targeting/search` with `dimension=interest`. 
+    # @param q [String] Search query
+    # @param account_id [String] Social account ID
+    # @param [Hash] opts the optional parameters
+    # @return [SearchAdInterests200Response]
+    def search_ad_interests(q, account_id, opts = {})
+      data, _status_code, _headers = search_ad_interests_with_http_info(q, account_id, opts)
+      data
+    end
+
+    # Search targeting interests
+    # Deprecated alias for &#x60;GET /v1/ads/targeting/search?dimension&#x3D;interest&#x60;. Kept for backward compatibility, it returns the legacy &#x60;{ interests: [...] }&#x60; shape rather than the normalized &#x60;{ results: [...] }&#x60;. New integrations should use &#x60;GET /v1/ads/targeting/search&#x60; with &#x60;dimension&#x3D;interest&#x60;. 
+    # @param q [String] Search query
+    # @param account_id [String] Social account ID
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SearchAdInterests200Response, Integer, Hash)>] SearchAdInterests200Response data, response status code and response headers
+    def search_ad_interests_with_http_info(q, account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdTargetingApi.search_ad_interests ...'
+      end
+      # verify the required parameter 'q' is set
+      if @api_client.config.client_side_validation && q.nil?
+        fail ArgumentError, "Missing the required parameter 'q' when calling AdTargetingApi.search_ad_interests"
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AdTargetingApi.search_ad_interests"
+      end
+      # resource path
+      local_var_path = '/v1/ads/interests'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'q'] = q
+      query_params[:'accountId'] = account_id
+
+      # 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] || 'SearchAdInterests200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdTargetingApi.search_ad_interests",
+        :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: AdTargetingApi#search_ad_interests\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search targeting options
+    # Resolve a human-readable query into the platform's opaque targeting ids used in the `TargetingSpec` (`countries`/`regions`/`cities`/`zips`/`metros` geo keys, and `interests`/`behaviors` entity ids) on `POST /v1/ads/create`, `POST /v1/ads/targeting/reach-estimate`, and `saved_targeting` audiences.  The `dimension` param selects what is searched, `geo` (locations, further scoped by `geoType`), `interest`, `behavior`, or `income`. Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only). Results are normalized across platforms into a single shape, so the same client code consumes Meta, TikTok, LinkedIn, X, Pinterest, and Google results.  TikTok geo searches return every matching level in one list (`type` is `country`, `region`, `city`, `district`, or `metro` for DMA areas) — `geoType` is not applied. Results are scoped to the advertiser's targetable markets, and every id is usable in `regions`/`cities`/`metros` keys on `POST /v1/ads/create`.  For geo queries, `q` should contain only the locality name (e.g. `\"Amsterdam\"`, not `\"Amsterdam, NL\"`). Use `countryCode` to disambiguate. 
+    # @param account_id [String] Social account ID (a connected account on the target ad platform).
+    # @param q [String] Search query. For geo, the locality name only (no region/country suffix).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :dimension What to search. &#x60;geo&#x60; resolves locations (scope further with &#x60;geoType&#x60;), &#x60;interest&#x60;/&#x60;behavior&#x60; resolve audience entities, &#x60;income&#x60; resolves income-tier options. Defaults to &#x60;interest&#x60; for backward compatibility with the deprecated /v1/ads/interests alias. (default to 'interest')
+    # @option opts [String] :geo_type Only used when &#x60;dimension&#x3D;geo&#x60;. The kind of location to resolve. Defaults to &#x60;city&#x60;. (default to 'city')
+    # @option opts [String] :country_code ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
+    # @option opts [Integer] :limit Maximum results to return. (default to 25)
+    # @return [SearchAdTargeting200Response]
+    def search_ad_targeting(account_id, q, opts = {})
+      data, _status_code, _headers = search_ad_targeting_with_http_info(account_id, q, opts)
+      data
+    end
+
+    # Search targeting options
+    # Resolve a human-readable query into the platform&#39;s opaque targeting ids used in the &#x60;TargetingSpec&#x60; (&#x60;countries&#x60;/&#x60;regions&#x60;/&#x60;cities&#x60;/&#x60;zips&#x60;/&#x60;metros&#x60; geo keys, and &#x60;interests&#x60;/&#x60;behaviors&#x60; entity ids) on &#x60;POST /v1/ads/create&#x60;, &#x60;POST /v1/ads/targeting/reach-estimate&#x60;, and &#x60;saved_targeting&#x60; audiences.  The &#x60;dimension&#x60; param selects what is searched, &#x60;geo&#x60; (locations, further scoped by &#x60;geoType&#x60;), &#x60;interest&#x60;, &#x60;behavior&#x60;, or &#x60;income&#x60;. Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only). Results are normalized across platforms into a single shape, so the same client code consumes Meta, TikTok, LinkedIn, X, Pinterest, and Google results.  TikTok geo searches return every matching level in one list (&#x60;type&#x60; is &#x60;country&#x60;, &#x60;region&#x60;, &#x60;city&#x60;, &#x60;district&#x60;, or &#x60;metro&#x60; for DMA areas) — &#x60;geoType&#x60; is not applied. Results are scoped to the advertiser&#39;s targetable markets, and every id is usable in &#x60;regions&#x60;/&#x60;cities&#x60;/&#x60;metros&#x60; keys on &#x60;POST /v1/ads/create&#x60;.  For geo queries, &#x60;q&#x60; should contain only the locality name (e.g. &#x60;\&quot;Amsterdam\&quot;&#x60;, not &#x60;\&quot;Amsterdam, NL\&quot;&#x60;). Use &#x60;countryCode&#x60; to disambiguate. 
+    # @param account_id [String] Social account ID (a connected account on the target ad platform).
+    # @param q [String] Search query. For geo, the locality name only (no region/country suffix).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :dimension What to search. &#x60;geo&#x60; resolves locations (scope further with &#x60;geoType&#x60;), &#x60;interest&#x60;/&#x60;behavior&#x60; resolve audience entities, &#x60;income&#x60; resolves income-tier options. Defaults to &#x60;interest&#x60; for backward compatibility with the deprecated /v1/ads/interests alias. (default to 'interest')
+    # @option opts [String] :geo_type Only used when &#x60;dimension&#x3D;geo&#x60;. The kind of location to resolve. Defaults to &#x60;city&#x60;. (default to 'city')
+    # @option opts [String] :country_code ISO 3166-1 alpha-2 country code (e.g. NL) to scope a geo search.
+    # @option opts [Integer] :limit Maximum results to return. (default to 25)
+    # @return [Array<(SearchAdTargeting200Response, Integer, Hash)>] SearchAdTargeting200Response data, response status code and response headers
+    def search_ad_targeting_with_http_info(account_id, q, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdTargetingApi.search_ad_targeting ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AdTargetingApi.search_ad_targeting"
+      end
+      # verify the required parameter 'q' is set
+      if @api_client.config.client_side_validation && q.nil?
+        fail ArgumentError, "Missing the required parameter 'q' when calling AdTargetingApi.search_ad_targeting"
+      end
+      allowable_values = ["geo", "interest", "behavior", "income"]
+      if @api_client.config.client_side_validation && opts[:'dimension'] && !allowable_values.include?(opts[:'dimension'])
+        fail ArgumentError, "invalid value for \"dimension\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["country", "region", "city", "zip", "metro"]
+      if @api_client.config.client_side_validation && opts[:'geo_type'] && !allowable_values.include?(opts[:'geo_type'])
+        fail ArgumentError, "invalid value for \"geo_type\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'country_code'].nil? && opts[:'country_code'].to_s.length > 2
+        fail ArgumentError, 'invalid value for "opts[:"country_code"]" when calling AdTargetingApi.search_ad_targeting, the character length must be smaller than or equal to 2.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'country_code'].nil? && opts[:'country_code'].to_s.length < 2
+        fail ArgumentError, 'invalid value for "opts[:"country_code"]" when calling AdTargetingApi.search_ad_targeting, the character length must be greater than or equal to 2.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdTargetingApi.search_ad_targeting, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling AdTargetingApi.search_ad_targeting, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v1/ads/targeting/search'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'accountId'] = account_id
+      query_params[:'q'] = q
+      query_params[:'dimension'] = opts[:'dimension'] if !opts[:'dimension'].nil?
+      query_params[:'geoType'] = opts[:'geo_type'] if !opts[:'geo_type'].nil?
+      query_params[:'countryCode'] = opts[:'country_code'] if !opts[:'country_code'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchAdTargeting200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdTargetingApi.search_ad_targeting",
+        :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: AdTargetingApi#search_ad_targeting\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

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

@@ -1614,12 +1614,12 @@ module Zernio
     end
 
     # Get YouTube daily views
-    # Returns daily view counts for a YouTube video including views, watch time, and subscriber changes. Requires yt-analytics.readonly scope (re-authorization may be needed). Data has a 2-3 day delay. Max 90 days, defaults to last 30 days. 
+    # Returns daily view counts for a YouTube video including views, watch time, and subscriber changes. Requires yt-analytics.readonly scope (re-authorization may be needed). YouTube finalizes analytics with a ~3-day delay; by default only finalized days are returned, and an explicit endDate can reach into the delay window (see the endDate parameter). Max 90 days, defaults to last 30 days. 
     # @param video_id [String] The YouTube video ID (e.g., \"dQw4w9WgXcQ\")
     # @param account_id [String] The Zernio account ID for the YouTube account
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :start_date Start date (YYYY-MM-DD). Defaults to 30 days ago.
-    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago (YouTube data latency).
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response), and days YouTube has not processed yet are omitted from dailyViews. 
     # @return [YouTubeDailyViewsResponse]
     def get_you_tube_daily_views(video_id, account_id, opts = {})
       data, _status_code, _headers = get_you_tube_daily_views_with_http_info(video_id, account_id, opts)
@@ -1627,12 +1627,12 @@ module Zernio
     end
 
     # Get YouTube daily views
-    # Returns daily view counts for a YouTube video including views, watch time, and subscriber changes. Requires yt-analytics.readonly scope (re-authorization may be needed). Data has a 2-3 day delay. Max 90 days, defaults to last 30 days. 
+    # Returns daily view counts for a YouTube video including views, watch time, and subscriber changes. Requires yt-analytics.readonly scope (re-authorization may be needed). YouTube finalizes analytics with a ~3-day delay; by default only finalized days are returned, and an explicit endDate can reach into the delay window (see the endDate parameter). Max 90 days, defaults to last 30 days. 
     # @param video_id [String] The YouTube video ID (e.g., \"dQw4w9WgXcQ\")
     # @param account_id [String] The Zernio account ID for the YouTube account
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :start_date Start date (YYYY-MM-DD). Defaults to 30 days ago.
-    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago (YouTube data latency).
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response), and days YouTube has not processed yet are omitted from dailyViews. 
     # @return [Array<(YouTubeDailyViewsResponse, Integer, Hash)>] YouTubeDailyViewsResponse data, response status code and response headers
     def get_you_tube_daily_views_with_http_info(video_id, account_id, opts = {})
       if @api_client.config.debugging
@@ -1697,7 +1697,7 @@ module Zernio
     # @option opts [String] :video_id YouTube video ID. When provided, demographics are scoped to this single video (must belong to the connected channel; otherwise 404 video_not_found). 
     # @option opts [String] :breakdown Comma-separated list of demographic dimensions: age, gender, country. Defaults to all three if omitted. 
     # @option opts [Date] :start_date Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video&#39;s publish date (lifetime) when videoId is provided. 
-    # @option opts [Date] :end_date End date in YYYY-MM-DD format. Defaults to 3 days ago (YouTube data latency). 
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response). 
     # @return [YouTubeDemographicsResponse]
     def get_you_tube_demographics(account_id, opts = {})
       data, _status_code, _headers = get_you_tube_demographics_with_http_info(account_id, opts)
@@ -1711,7 +1711,7 @@ module Zernio
     # @option opts [String] :video_id YouTube video ID. When provided, demographics are scoped to this single video (must belong to the connected channel; otherwise 404 video_not_found). 
     # @option opts [String] :breakdown Comma-separated list of demographic dimensions: age, gender, country. Defaults to all three if omitted. 
     # @option opts [Date] :start_date Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video&#39;s publish date (lifetime) when videoId is provided. 
-    # @option opts [Date] :end_date End date in YYYY-MM-DD format. Defaults to 3 days ago (YouTube data latency). 
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response). 
     # @return [Array<(YouTubeDemographicsResponse, Integer, Hash)>] YouTubeDemographicsResponse data, response status code and response headers
     def get_you_tube_demographics_with_http_info(account_id, opts = {})
       if @api_client.config.debugging
@@ -1772,7 +1772,7 @@ module Zernio
     # @param account_id [String] The Zernio account ID for the YouTube account
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :start_date Start date (YYYY-MM-DD). Defaults to the video&#39;s publish date (lifetime curve).
-    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago (YouTube data latency).
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response). 
     # @return [YouTubeVideoRetentionResponse]
     def get_you_tube_video_retention(video_id, account_id, opts = {})
       data, _status_code, _headers = get_you_tube_video_retention_with_http_info(video_id, account_id, opts)
@@ -1785,7 +1785,7 @@ module Zernio
     # @param account_id [String] The Zernio account ID for the YouTube account
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :start_date Start date (YYYY-MM-DD). Defaults to the video&#39;s publish date (lifetime curve).
-    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago (YouTube data latency).
+    # @option opts [Date] :end_date End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit endDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response). 
     # @return [Array<(YouTubeVideoRetentionResponse, Integer, Hash)>] YouTubeVideoRetentionResponse data, response status code and response headers
     def get_you_tube_video_retention_with_http_info(video_id, account_id, opts = {})
       if @api_client.config.debugging