late-sdk 0.0.528 → 0.0.530

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

@@ -373,6 +373,74 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Create Click-to-Call ad
+    # Same shape and flow as POST /v1/ads/ctwa, but the CTA is CALL_NOW dialing `phoneNumber` via a tel: link. The ad set is destination_type PHONE_CALL optimizing QUALITY_CALL and the campaign objective defaults to OUTCOME_LEADS. Supports the same single-creative and multi-creative shapes as CTWA.
+    # @param create_call_ad_request [CreateCallAdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def create_call_ad(create_call_ad_request, opts = {})
+      create_call_ad_with_http_info(create_call_ad_request, opts)
+      nil
+    end
+
+    # Create Click-to-Call ad
+    # Same shape and flow as POST /v1/ads/ctwa, but the CTA is CALL_NOW dialing `phoneNumber` via a tel: link. The ad set is destination_type PHONE_CALL optimizing QUALITY_CALL and the campaign objective defaults to OUTCOME_LEADS. Supports the same single-creative and multi-creative shapes as CTWA.
+    # @param create_call_ad_request [CreateCallAdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def create_call_ad_with_http_info(create_call_ad_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdsApi.create_call_ad ...'
+      end
+      # verify the required parameter 'create_call_ad_request' is set
+      if @api_client.config.client_side_validation && create_call_ad_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_call_ad_request' when calling AdsApi.create_call_ad"
+      end
+      # resource path
+      local_var_path = '/v1/ads/call'
+
+      # 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(create_call_ad_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdsApi.create_call_ad",
+        :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: AdsApi#create_call_ad\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create a conversion destination
     # Create a new conversion destination on the platform. Supported for LinkedIn (conversion rule) and Google Ads (conversion action). Meta manages destinations in its own UI and returns 405.  **LinkedIn:** creation is NOT idempotent. A retry creates a second destination. Deduplicate before retrying.  **Google Ads:** calling with a name that already exists reuses the existing conversion action transparently (the response is identical to a fresh create). Calling with the same name but a different category returns a typed `IDEMPOTENCY_CONFLICT` (409) rather than silently returning the mismatched action.  **LinkedIn:** the rule is created with `conversionMethod=CONVERSIONS_API` and (by default) auto-associated with all of the ad account's campaigns via `autoAssociationType=ALL_CAMPAIGNS`. Pass `autoAssociationType: NONE` to opt out and manage associations explicitly via the associations endpoints below.  365-day attribution windows are only valid for `SUBMIT_APPLICATION`, `PURCHASE`, `ADD_TO_CART`, `QUALIFIED_LEAD`, and `LEAD` rule types; the API rejects other combinations locally.  **Google Ads:** the conversion action is created with `type=UPLOAD_CLICKS` (required for API-uploaded offline conversions, immutable after creation). The `type` field carries the Google `ConversionActionCategory` enum value, e.g. `PURCHASE`, `SUBSCRIBE_PAID`, `SIGNUP`, `IMPORTED_LEAD`, `BOOK_APPOINTMENT`. Unified standard event names (e.g. `Purchase`, `Subscribe`, `CompleteRegistration`, `Lead`, `Schedule`) are resolved to their Google category equivalents automatically. The action defaults to secondary (non-primary) to avoid immediately steering Smart Bidding; pass `primaryForGoal: true` to opt in. 
     # @param account_id [String] SocialAccount ID (linkedinads or googleads).
@@ -447,28 +515,28 @@ module Zernio
       return data, status_code, headers
     end
 
-    # Create Click-to-WhatsApp ad
-    # Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.  Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
-    # @param create_ctwa_ad_request [CreateCtwaAdRequest] 
+    # Create Click-to-WhatsApp ad (deprecated)
+    # Deprecated: use POST /v1/ads/messaging with `destination: whatsapp`. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level `headline`, `body`, and one of `imageUrl` / `video`. Creates 1 campaign + 1 ad set + 1 ad.  - **Multi-creative**: supply a `creatives[]` array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.  Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
+    # @param ctwa_ad_request_body [CtwaAdRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [CreateCtwaAd201Response]
-    def create_ctwa_ad(create_ctwa_ad_request, opts = {})
-      data, _status_code, _headers = create_ctwa_ad_with_http_info(create_ctwa_ad_request, opts)
+    def create_ctwa_ad(ctwa_ad_request_body, opts = {})
+      data, _status_code, _headers = create_ctwa_ad_with_http_info(ctwa_ad_request_body, opts)
       data
     end
 
-    # Create Click-to-WhatsApp ad
-    # Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level &#x60;headline&#x60;, &#x60;body&#x60;, and one of &#x60;imageUrl&#x60; / &#x60;video&#x60;. Creates 1 campaign + 1 ad set + 1 ad.  - **Multi-creative**: supply a &#x60;creatives[]&#x60; array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.  Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
-    # @param create_ctwa_ad_request [CreateCtwaAdRequest] 
+    # Create Click-to-WhatsApp ad (deprecated)
+    # Deprecated: use POST /v1/ads/messaging with &#x60;destination: whatsapp&#x60;. This endpoint stays available for back-compat; no removal planned.  Creates one or more Click-to-WhatsApp (CTWA) ads on Meta under a single campaign and ad set. When tapped, each ad opens a WhatsApp conversation with the business attached to the supplied Facebook Page. The full hierarchy (campaign, ad set, creative(s), ad(s)) is created and activated in one call. The CTA is locked to WHATSAPP_MESSAGE and the destination is hard-coded to api.whatsapp.com/send; Meta resolves the actual WhatsApp number from the Page-to-WA pairing configured in Page settings or Business Manager.  Supports two mutually-exclusive shapes:  - **Single-creative**: supply top-level &#x60;headline&#x60;, &#x60;body&#x60;, and one of &#x60;imageUrl&#x60; / &#x60;video&#x60;. Creates 1 campaign + 1 ad set + 1 ad.  - **Multi-creative**: supply a &#x60;creatives[]&#x60; array with N entries (each carrying its own headline, body, and image/video). Creates 1 campaign + 1 ad set + N ads sharing budget and targeting so Meta A/Bs the creatives inside a single auction instead of fragmenting budget across N parallel campaigns. Recommended when launching multiple creative variants for the same campaign.  Prerequisites enforced by Meta (surfaced as platform_error on failure): the Facebook Page must be paired with a verified WhatsApp Business number, the WhatsApp Business Account must be business-verified, and the Meta access token must carry ads_management.
+    # @param ctwa_ad_request_body [CtwaAdRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(CreateCtwaAd201Response, Integer, Hash)>] CreateCtwaAd201Response data, response status code and response headers
-    def create_ctwa_ad_with_http_info(create_ctwa_ad_request, opts = {})
+    def create_ctwa_ad_with_http_info(ctwa_ad_request_body, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdsApi.create_ctwa_ad ...'
       end
-      # verify the required parameter 'create_ctwa_ad_request' is set
-      if @api_client.config.client_side_validation && create_ctwa_ad_request.nil?
-        fail ArgumentError, "Missing the required parameter 'create_ctwa_ad_request' when calling AdsApi.create_ctwa_ad"
+      # verify the required parameter 'ctwa_ad_request_body' is set
+      if @api_client.config.client_side_validation && ctwa_ad_request_body.nil?
+        fail ArgumentError, "Missing the required parameter 'ctwa_ad_request_body' when calling AdsApi.create_ctwa_ad"
       end
       # resource path
       local_var_path = '/v1/ads/ctwa'
@@ -490,7 +558,7 @@ module Zernio
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_ctwa_ad_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(ctwa_ad_request_body)
 
       # return_type
       return_type = opts[:debug_return_type] || 'CreateCtwaAd201Response'
@@ -583,6 +651,74 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+    # Creates a click-to-message ad; `destination` selects where the tapped ad opens a conversation: WhatsApp, the Page's Messenger inbox or the linked Instagram account's Direct inbox. The ad set is created with the matching destination_type and CONVERSATIONS optimization; the campaign objective defaults to OUTCOME_ENGAGEMENT. Supports single-creative and multi-creative shapes. Supersedes POST /v1/ads/ctwa (deprecated, equivalent to `destination: whatsapp`).
+    # @param create_messaging_ad_request [CreateMessagingAdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def create_messaging_ad(create_messaging_ad_request, opts = {})
+      create_messaging_ad_with_http_info(create_messaging_ad_request, opts)
+      nil
+    end
+
+    # Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+    # Creates a click-to-message ad; &#x60;destination&#x60; selects where the tapped ad opens a conversation: WhatsApp, the Page&#39;s Messenger inbox or the linked Instagram account&#39;s Direct inbox. The ad set is created with the matching destination_type and CONVERSATIONS optimization; the campaign objective defaults to OUTCOME_ENGAGEMENT. Supports single-creative and multi-creative shapes. Supersedes POST /v1/ads/ctwa (deprecated, equivalent to &#x60;destination: whatsapp&#x60;).
+    # @param create_messaging_ad_request [CreateMessagingAdRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def create_messaging_ad_with_http_info(create_messaging_ad_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdsApi.create_messaging_ad ...'
+      end
+      # verify the required parameter 'create_messaging_ad_request' is set
+      if @api_client.config.client_side_validation && create_messaging_ad_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_messaging_ad_request' when calling AdsApi.create_messaging_ad"
+      end
+      # resource path
+      local_var_path = '/v1/ads/messaging'
+
+      # 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(create_messaging_ad_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdsApi.create_messaging_ad",
+        :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: AdsApi#create_messaging_ad\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create standalone ad
     # Creates a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X/Twitter, and LinkedIn. Supports three mutually-exclusive request shapes selected by the body, a legacy single-creative shape (all platforms, default), a Meta-only multi-creative shape via the creatives array (one ad set with N ads sharing budget and targeting), and a Meta-only attach shape via adSetId (adds one new ad to an existing ad set). Per-platform required fields, budget minimums, and video-ad rules are documented on each property below. LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content \"dark post\" authored by a Company Page (see `organizationId`); supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.  **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
     # @param create_standalone_ad_request [CreateStandaloneAdRequest] 
@@ -935,6 +1071,74 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Render pre-create ad previews (Meta)
+    # Renders how a creative would look per placement BEFORE any ad exists, via Meta's `/generatepreviews`. Provide exactly one creative source: `existingCreativeId` or `creativeSpec`. Each preview is an HTML `<iframe>` snippet embeddable directly. Unknown `formats` values return Meta's 400 verbatim. Meta only. 
+    # @param generate_ad_previews_request [GenerateAdPreviewsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [GenerateAdPreviews200Response]
+    def generate_ad_previews(generate_ad_previews_request, opts = {})
+      data, _status_code, _headers = generate_ad_previews_with_http_info(generate_ad_previews_request, opts)
+      data
+    end
+
+    # Render pre-create ad previews (Meta)
+    # Renders how a creative would look per placement BEFORE any ad exists, via Meta&#39;s &#x60;/generatepreviews&#x60;. Provide exactly one creative source: &#x60;existingCreativeId&#x60; or &#x60;creativeSpec&#x60;. Each preview is an HTML &#x60;&lt;iframe&gt;&#x60; snippet embeddable directly. Unknown &#x60;formats&#x60; values return Meta&#39;s 400 verbatim. Meta only. 
+    # @param generate_ad_previews_request [GenerateAdPreviewsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GenerateAdPreviews200Response, Integer, Hash)>] GenerateAdPreviews200Response data, response status code and response headers
+    def generate_ad_previews_with_http_info(generate_ad_previews_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdsApi.generate_ad_previews ...'
+      end
+      # verify the required parameter 'generate_ad_previews_request' is set
+      if @api_client.config.client_side_validation && generate_ad_previews_request.nil?
+        fail ArgumentError, "Missing the required parameter 'generate_ad_previews_request' when calling AdsApi.generate_ad_previews"
+      end
+      # resource path
+      local_var_path = '/v1/ads/preview'
+
+      # 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(generate_ad_previews_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GenerateAdPreviews200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdsApi.generate_ad_previews",
+        :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: AdsApi#generate_ad_previews\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get ad details
     # Returns an ad with its creative, targeting, status, and performance metrics.  The `{adId}` path segment accepts any identifier dialect Zernio indexes for the ad: - the Zernio internal `_id` (24-char hex) - Meta's numeric `platformAdId` (the value shipped in `comment.received` webhooks as `comment.ad.id`) - the creative's `effective_object_story_id` (`{pageId}_{postId}` shape, Facebook side) - the creative's `effective_instagram_media_id` (Instagram side)  Any of the four resolve to the same ad. Caller doesn't need a translation step. 
     # @param ad_id [String] Zernio &#x60;_id&#x60; (hex), Meta &#x60;platformAdId&#x60; (numeric), or one of the creative&#39;s effective story/media IDs. See description for details. 
@@ -1238,6 +1442,72 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Render previews of an existing ad (Meta)
+    # Renders an EXISTING ad per placement via Meta's `/{ad_id}/previews`. Each preview is an HTML `<iframe>` snippet embeddable directly. Unknown `formats` values return Meta's 400 verbatim. Meta only. 
+    # @param ad_id [String] Zernio ad id (24-char hex).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :formats Comma-separated Meta ad_format values (max 10), one preview per format. Defaults to DESKTOP_FEED_STANDARD.
+    # @return [GetAdPreviews200Response]
+    def get_ad_previews(ad_id, opts = {})
+      data, _status_code, _headers = get_ad_previews_with_http_info(ad_id, opts)
+      data
+    end
+
+    # Render previews of an existing ad (Meta)
+    # Renders an EXISTING ad per placement via Meta&#39;s &#x60;/{ad_id}/previews&#x60;. Each preview is an HTML &#x60;&lt;iframe&gt;&#x60; snippet embeddable directly. Unknown &#x60;formats&#x60; values return Meta&#39;s 400 verbatim. Meta only. 
+    # @param ad_id [String] Zernio ad id (24-char hex).
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :formats Comma-separated Meta ad_format values (max 10), one preview per format. Defaults to DESKTOP_FEED_STANDARD.
+    # @return [Array<(GetAdPreviews200Response, Integer, Hash)>] GetAdPreviews200Response data, response status code and response headers
+    def get_ad_previews_with_http_info(ad_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdsApi.get_ad_previews ...'
+      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 AdsApi.get_ad_previews"
+      end
+      # resource path
+      local_var_path = '/v1/ads/{adId}/preview'.sub('{' + 'adId' + '}', CGI.escape(ad_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'formats'] = opts[:'formats'] if !opts[:'formats'].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] || 'GetAdPreviews200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdsApi.get_ad_previews",
+        :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: AdsApi#get_ad_previews\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      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).
@@ -2841,6 +3111,10 @@ module Zernio
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted &#x3D; Meta&#39;s default set.
     # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+    # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
+    # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.
+    # @option opts [Boolean] :use_unified_attribution_setting Use the ad sets&#39; own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\&quot;field\&quot;, \&quot;operator\&quot;, \&quot;value\&quot;}]. Applied server-side by Meta.
     # @option opts [String] :date_preset Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
     # @option opts [Date] :from_date Start of range (YYYY-MM-DD); requires toDate.
@@ -2862,6 +3136,10 @@ module Zernio
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted &#x3D; Meta&#39;s default set.
     # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+    # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
+    # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.
+    # @option opts [Boolean] :use_unified_attribution_setting Use the ad sets&#39; own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\&quot;field\&quot;, \&quot;operator\&quot;, \&quot;value\&quot;}]. Applied server-side by Meta.
     # @option opts [String] :date_preset Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
     # @option opts [Date] :from_date Start of range (YYYY-MM-DD); requires toDate.
@@ -2904,6 +3182,10 @@ module Zernio
       query_params[:'level'] = opts[:'level'] if !opts[:'level'].nil?
       query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
       query_params[:'breakdowns'] = opts[:'breakdowns'] if !opts[:'breakdowns'].nil?
+      query_params[:'actionBreakdowns'] = opts[:'action_breakdowns'] if !opts[:'action_breakdowns'].nil?
+      query_params[:'actionAttributionWindows'] = opts[:'action_attribution_windows'] if !opts[:'action_attribution_windows'].nil?
+      query_params[:'actionReportTime'] = opts[:'action_report_time'] if !opts[:'action_report_time'].nil?
+      query_params[:'useUnifiedAttributionSetting'] = opts[:'use_unified_attribution_setting'] if !opts[:'use_unified_attribution_setting'].nil?
       query_params[:'filtering'] = opts[:'filtering'] if !opts[:'filtering'].nil?
       query_params[:'datePreset'] = opts[:'date_preset'] if !opts[:'date_preset'].nil?
       query_params[:'fromDate'] = opts[:'from_date'] if !opts[:'from_date'].nil?

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

@@ -29,6 +29,18 @@ module Zernio
     # Comma-separated Graph breakdowns.
     attr_accessor :breakdowns
 
+    # Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
+    attr_accessor :action_breakdowns
+
+    # Meta attribution windows (e.g. [\"7d_click\", \"1d_view\"]). Action values are returned keyed per window.
+    attr_accessor :action_attribution_windows
+
+    # When actions are counted: impression, conversion or mixed.
+    attr_accessor :action_report_time
+
+    # Use the ad sets' own attribution settings for action counting.
+    attr_accessor :use_unified_attribution_setting
+
     # Meta filter objects, applied server-side.
     attr_accessor :filtering
 
@@ -71,6 +83,10 @@ module Zernio
         :'level' => :'level',
         :'fields' => :'fields',
         :'breakdowns' => :'breakdowns',
+        :'action_breakdowns' => :'actionBreakdowns',
+        :'action_attribution_windows' => :'actionAttributionWindows',
+        :'action_report_time' => :'actionReportTime',
+        :'use_unified_attribution_setting' => :'useUnifiedAttributionSetting',
         :'filtering' => :'filtering',
         :'date_preset' => :'datePreset',
         :'from_date' => :'fromDate',
@@ -97,6 +113,10 @@ module Zernio
         :'level' => :'String',
         :'fields' => :'String',
         :'breakdowns' => :'String',
+        :'action_breakdowns' => :'String',
+        :'action_attribution_windows' => :'Array<String>',
+        :'action_report_time' => :'String',
+        :'use_unified_attribution_setting' => :'Boolean',
         :'filtering' => :'Array<CreateAdInsightsReportRequestFilteringInner>',
         :'date_preset' => :'String',
         :'from_date' => :'Date',
@@ -151,6 +171,24 @@ module Zernio
         self.breakdowns = attributes[:'breakdowns']
       end
 
+      if attributes.key?(:'action_breakdowns')
+        self.action_breakdowns = attributes[:'action_breakdowns']
+      end
+
+      if attributes.key?(:'action_attribution_windows')
+        if (value = attributes[:'action_attribution_windows']).is_a?(Array)
+          self.action_attribution_windows = value
+        end
+      end
+
+      if attributes.key?(:'action_report_time')
+        self.action_report_time = attributes[:'action_report_time']
+      end
+
+      if attributes.key?(:'use_unified_attribution_setting')
+        self.use_unified_attribution_setting = attributes[:'use_unified_attribution_setting']
+      end
+
       if attributes.key?(:'filtering')
         if (value = attributes[:'filtering']).is_a?(Array)
           self.filtering = value
@@ -241,6 +279,10 @@ module Zernio
           level == o.level &&
           fields == o.fields &&
           breakdowns == o.breakdowns &&
+          action_breakdowns == o.action_breakdowns &&
+          action_attribution_windows == o.action_attribution_windows &&
+          action_report_time == o.action_report_time &&
+          use_unified_attribution_setting == o.use_unified_attribution_setting &&
           filtering == o.filtering &&
           date_preset == o.date_preset &&
           from_date == o.from_date &&
@@ -257,7 +299,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, object_id, level, fields, breakdowns, filtering, date_preset, from_date, to_date, time_increment].hash
+      [account_id, object_id, level, fields, breakdowns, action_breakdowns, action_attribution_windows, action_report_time, use_unified_attribution_setting, filtering, date_preset, from_date, to_date, time_increment].hash
     end
 
     # Builds the object from hash