zernio-sdk 0.0.528 → 0.0.529

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2512b46748f0d6cfcc7050fb70e9e94abe230e6bb68d9949d75808ac1fe393e
-  data.tar.gz: 24ae76e6fb6124854c7d0f98b0577d1c79439a58a3f920a554e7d2144b431a4e
+  metadata.gz: 2e0db6a79e9e00f953f3027692b48bb968aca3afcf369eb2b39a1d3e7fe8c9c4
+  data.tar.gz: fadcc6fc532b75244e7488b02a5f115345f7aedd432c284d3ba2e5dd565dd0ef
 SHA512:
-  metadata.gz: 20214a9e6724ec1127a30da6268d7b2fbb0bf25e4f6e453cec50462fbba8c80ffd2d0373e6a3834737f36dddd909e721f1f33de66c829c9bab9f11aebcd5ef79
-  data.tar.gz: ac5951dbf679d2c3ebe3aa184ad460830a6c534e50905b0f9a7141e1ff48a577b465127def86097c6359cd249d555bd832f8e3db1a24a3b0d5cf168057cc3e4b
+  metadata.gz: b01573d5ee8adf9f841cf202c718f6b7c9080038e83bce3f3aee59fc7d3495428e208cb3f58891bccd1e2a94b58797cdce10982eeeb44b3e411529b821bb4966
+  data.tar.gz: c46db1bad44769174f88ce13a5ecc7f81fe4d353485c4ab69fb582f9825296417f38d58928c8a26891c0ebcd2abf10620d56a05bb6a8c6e9c79279ada1b6a22d

data/README.md

@@ -780,6 +780,7 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateStandaloneAdRequestAttributionSpecInner](docs/CreateStandaloneAdRequestAttributionSpecInner.md)
  - [Zernio::CreateStandaloneAdRequestBehaviorsInner](docs/CreateStandaloneAdRequestBehaviorsInner.md)
  - [Zernio::CreateStandaloneAdRequestBrandIdentity](docs/CreateStandaloneAdRequestBrandIdentity.md)
+ - [Zernio::CreateStandaloneAdRequestCarouselCardsInner](docs/CreateStandaloneAdRequestCarouselCardsInner.md)
  - [Zernio::CreateStandaloneAdRequestCitiesInner](docs/CreateStandaloneAdRequestCitiesInner.md)
  - [Zernio::CreateStandaloneAdRequestCreativesInner](docs/CreateStandaloneAdRequestCreativesInner.md)
  - [Zernio::CreateStandaloneAdRequestCreativesInnerVideo](docs/CreateStandaloneAdRequestCreativesInnerVideo.md)

data/docs/AdsApi.md

@@ -2850,6 +2850,10 @@ opts = {
   level: 'ad', # String | Row granularity
   fields: 'fields_example', # String | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
   breakdowns: 'breakdowns_example', # String | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+  action_breakdowns: 'action_breakdowns_example', # String | Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+  action_attribution_windows: 'action_attribution_windows_example', # String | Comma-separated Meta attribution windows. Action values are returned keyed per window.
+  action_report_time: 'action_report_time_example', # String | When actions are counted: impression, conversion or mixed.
+  use_unified_attribution_setting: true, # Boolean | Use the ad sets' own attribution settings for action counting.
   filtering: 'filtering_example', # String | JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta.
   date_preset: 'date_preset_example', # String | Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
   from_date: Date.parse('2013-10-20'), # Date | Start of range (YYYY-MM-DD); requires toDate.
@@ -2895,6 +2899,10 @@ end
 | **level** | **String** | Row granularity | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set. | [optional] |
 | **breakdowns** | **String** | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). | [optional] |
+| **action_breakdowns** | **String** | Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row. | [optional] |
+| **action_attribution_windows** | **String** | Comma-separated Meta attribution windows. Action values are returned keyed per window. | [optional] |
+| **action_report_time** | **String** | When actions are counted: impression, conversion or mixed. | [optional] |
+| **use_unified_attribution_setting** | **Boolean** | Use the ad sets' own attribution settings for action counting. | [optional] |
 | **filtering** | **String** | JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta. | [optional] |
 | **date_preset** | **String** | Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate. | [optional] |
 | **from_date** | **Date** | Start of range (YYYY-MM-DD); requires toDate. | [optional] |

data/docs/CreateAdInsightsReportRequest.md

@@ -9,6 +9,10 @@
 | **level** | **String** |  | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields. | [optional] |
 | **breakdowns** | **String** | Comma-separated Graph breakdowns. | [optional] |
+| **action_breakdowns** | **String** | Comma-separated Graph action breakdowns (e.g. action_type,action_destination). | [optional] |
+| **action_attribution_windows** | **Array<String>** | Meta attribution windows (e.g. [\"7d_click\", \"1d_view\"]). Action values are returned keyed per window. | [optional] |
+| **action_report_time** | **String** | When actions are counted: impression, conversion or mixed. | [optional] |
+| **use_unified_attribution_setting** | **Boolean** | Use the ad sets' own attribution settings for action counting. | [optional] |
 | **filtering** | [**Array<CreateAdInsightsReportRequestFilteringInner>**](CreateAdInsightsReportRequestFilteringInner.md) | Meta filter objects, applied server-side. | [optional] |
 | **date_preset** | **String** | Mutually exclusive with fromDate/toDate. | [optional] |
 | **from_date** | **Date** |  | [optional] |
@@ -26,6 +30,10 @@ instance = Zernio::CreateAdInsightsReportRequest.new(
   level: null,
   fields: null,
   breakdowns: null,
+  action_breakdowns: null,
+  action_attribution_windows: null,
+  action_report_time: null,
+  use_unified_attribution_setting: null,
   filtering: null,
   date_preset: null,
   from_date: null,

data/docs/CreateStandaloneAdRequest.md

@@ -57,6 +57,7 @@
 | **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we auto-resolve the IG account linked to the connected Facebook Page (the existing default). Useful when a Page has more than one eligible IG account.  | [optional] |
 | **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
+| **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`.  | [optional] |
 | **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID for targeting | [optional] |
 | **campaign_type** | **String** | Google only | [optional][default to 'display'] |
@@ -135,6 +136,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   start_date: null,
   instagram_account_id: null,
   dynamic_creative: null,
+  carousel_cards: null,
   placement_assets: null,
   audience_id: null,
   campaign_type: null,

data/docs/CreateStandaloneAdRequestCarouselCardsInner.md

@@ -0,0 +1,26 @@
+# Zernio::CreateStandaloneAdRequestCarouselCardsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image_url** | **String** | Card image; uploaded to the ad account and referenced by hash. |  |
+| **link_url** | **String** | Card destination URL. Defaults to the top-level linkUrl. | [optional] |
+| **headline** | **String** | Card headline, shown below the card image. | [optional] |
+| **description** | **String** | Card description, shown under the headline. | [optional] |
+| **call_to_action** | **String** | Card CTA override. Defaults to the top-level callToAction; same enum. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCarouselCardsInner.new(
+  image_url: null,
+  link_url: null,
+  headline: null,
+  description: null,
+  call_to_action: null
+)
+```
+

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

@@ -2841,6 +2841,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 = Meta'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' own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. 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 +2866,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 = Meta'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' own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. 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 +2912,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

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

@@ -163,6 +163,9 @@ module Zernio
 
     attr_accessor :dynamic_creative
 
+    # Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`. 
+    attr_accessor :carousel_cards
+
     attr_accessor :placement_assets
 
     # Custom audience ID for targeting
@@ -291,6 +294,7 @@ module Zernio
         :'start_date' => :'startDate',
         :'instagram_account_id' => :'instagramAccountId',
         :'dynamic_creative' => :'dynamicCreative',
+        :'carousel_cards' => :'carouselCards',
         :'placement_assets' => :'placementAssets',
         :'audience_id' => :'audienceId',
         :'campaign_type' => :'campaignType',
@@ -378,6 +382,7 @@ module Zernio
         :'start_date' => :'Time',
         :'instagram_account_id' => :'String',
         :'dynamic_creative' => :'CreateStandaloneAdRequestDynamicCreative',
+        :'carousel_cards' => :'Array<CreateStandaloneAdRequestCarouselCardsInner>',
         :'placement_assets' => :'CreateStandaloneAdRequestPlacementAssets',
         :'audience_id' => :'String',
         :'campaign_type' => :'String',
@@ -665,6 +670,12 @@ module Zernio
         self.dynamic_creative = attributes[:'dynamic_creative']
       end
 
+      if attributes.key?(:'carousel_cards')
+        if (value = attributes[:'carousel_cards']).is_a?(Array)
+          self.carousel_cards = value
+        end
+      end
+
       if attributes.key?(:'placement_assets')
         self.placement_assets = attributes[:'placement_assets']
       end
@@ -815,6 +826,14 @@ module Zernio
         invalid_properties.push('invalid value for "age_max", must be greater than or equal to 13.')
       end
 
+      if !@carousel_cards.nil? && @carousel_cards.length > 10
+        invalid_properties.push('invalid value for "carousel_cards", number of items must be less than or equal to 10.')
+      end
+
+      if !@carousel_cards.nil? && @carousel_cards.length < 2
+        invalid_properties.push('invalid value for "carousel_cards", number of items must be greater than or equal to 2.')
+      end
+
       if !@attribution_spec.nil? && @attribution_spec.length > 3
         invalid_properties.push('invalid value for "attribution_spec", number of items must be less than or equal to 3.')
       end
@@ -865,6 +884,8 @@ module Zernio
       return false if !@age_max.nil? && @age_max < 13
       income_tier_validator = EnumAttributeValidator.new('String', ["top_5", "top_10", "top_10_25", "top_25_50"])
       return false unless income_tier_validator.valid?(@income_tier)
+      return false if !@carousel_cards.nil? && @carousel_cards.length > 10
+      return false if !@carousel_cards.nil? && @carousel_cards.length < 2
       campaign_type_validator = EnumAttributeValidator.new('String', ["display", "search"])
       return false unless campaign_type_validator.valid?(@campaign_type)
       advantage_audience_validator = EnumAttributeValidator.new('Integer', [0, 1])
@@ -1108,6 +1129,24 @@ module Zernio
       @income_tier = income_tier
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] carousel_cards Value to be assigned
+    def carousel_cards=(carousel_cards)
+      if carousel_cards.nil?
+        fail ArgumentError, 'carousel_cards cannot be nil'
+      end
+
+      if carousel_cards.length > 10
+        fail ArgumentError, 'invalid value for "carousel_cards", number of items must be less than or equal to 10.'
+      end
+
+      if carousel_cards.length < 2
+        fail ArgumentError, 'invalid value for "carousel_cards", number of items must be greater than or equal to 2.'
+      end
+
+      @carousel_cards = carousel_cards
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] campaign_type Object to be assigned
     def campaign_type=(campaign_type)
@@ -1252,6 +1291,7 @@ module Zernio
           start_date == o.start_date &&
           instagram_account_id == o.instagram_account_id &&
           dynamic_creative == o.dynamic_creative &&
+          carousel_cards == o.carousel_cards &&
           placement_assets == o.placement_assets &&
           audience_id == o.audience_id &&
           campaign_type == o.campaign_type &&
@@ -1281,7 +1321,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, campaign_name, ad_set_name, ad_name, tracking, goal, optimization_goal, billing_event, budget_amount, budget_type, status, budget_level, currency, headline, long_headline, body, description, call_to_action, link_url, lead_gen_form_id, image_url, images, video, creatives, ad_set_id, existing_campaign_id, existing_creative_id, business_name, board_id, organization_id, targeting, countries, cities, regions, age_min, age_max, interests, zips, metros, custom_locations, behaviors, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, end_date, start_date, instagram_account_id, dynamic_creative, placement_assets, audience_id, campaign_type, keywords, additional_headlines, additional_descriptions, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, promoted_object].hash
+      [account_id, ad_account_id, name, campaign_name, ad_set_name, ad_name, tracking, goal, optimization_goal, billing_event, budget_amount, budget_type, status, budget_level, currency, headline, long_headline, body, description, call_to_action, link_url, lead_gen_form_id, image_url, images, video, creatives, ad_set_id, existing_campaign_id, existing_creative_id, business_name, board_id, organization_id, targeting, countries, cities, regions, age_min, age_max, interests, zips, metros, custom_locations, behaviors, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, end_date, start_date, instagram_account_id, dynamic_creative, carousel_cards, placement_assets, audience_id, campaign_type, keywords, additional_headlines, additional_descriptions, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, promoted_object].hash
     end
 
     # Builds the object from hash

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

@@ -0,0 +1,243 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class CreateStandaloneAdRequestCarouselCardsInner < ApiModelBase
+    # Card image; uploaded to the ad account and referenced by hash.
+    attr_accessor :image_url
+
+    # Card destination URL. Defaults to the top-level linkUrl.
+    attr_accessor :link_url
+
+    # Card headline, shown below the card image.
+    attr_accessor :headline
+
+    # Card description, shown under the headline.
+    attr_accessor :description
+
+    # Card CTA override. Defaults to the top-level callToAction; same enum.
+    attr_accessor :call_to_action
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'image_url' => :'imageUrl',
+        :'link_url' => :'linkUrl',
+        :'headline' => :'headline',
+        :'description' => :'description',
+        :'call_to_action' => :'callToAction'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'image_url' => :'String',
+        :'link_url' => :'String',
+        :'headline' => :'String',
+        :'description' => :'String',
+        :'call_to_action' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::CreateStandaloneAdRequestCarouselCardsInner` 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::CreateStandaloneAdRequestCarouselCardsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'image_url')
+        self.image_url = attributes[:'image_url']
+      else
+        self.image_url = nil
+      end
+
+      if attributes.key?(:'link_url')
+        self.link_url = attributes[:'link_url']
+      end
+
+      if attributes.key?(:'headline')
+        self.headline = attributes[:'headline']
+      end
+
+      if attributes.key?(:'description')
+        self.description = attributes[:'description']
+      end
+
+      if attributes.key?(:'call_to_action')
+        self.call_to_action = attributes[:'call_to_action']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @image_url.nil?
+        invalid_properties.push('invalid value for "image_url", image_url cannot be nil.')
+      end
+
+      if !@headline.nil? && @headline.to_s.length > 255
+        invalid_properties.push('invalid value for "headline", the character length must be smaller than or equal to 255.')
+      end
+
+      if !@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
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @image_url.nil?
+      return false if !@headline.nil? && @headline.to_s.length > 255
+      return false if !@description.nil? && @description.to_s.length > 255
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] image_url Value to be assigned
+    def image_url=(image_url)
+      if image_url.nil?
+        fail ArgumentError, 'image_url cannot be nil'
+      end
+
+      @image_url = image_url
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] headline Value to be assigned
+    def headline=(headline)
+      if headline.nil?
+        fail ArgumentError, 'headline cannot be nil'
+      end
+
+      if headline.to_s.length > 255
+        fail ArgumentError, 'invalid value for "headline", the character length must be smaller than or equal to 255.'
+      end
+
+      @headline = headline
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] description Value to be assigned
+    def description=(description)
+      if description.nil?
+        fail ArgumentError, 'description cannot be nil'
+      end
+
+      if description.to_s.length > 255
+        fail ArgumentError, 'invalid value for "description", the character length must be smaller than or equal to 255.'
+      end
+
+      @description = description
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          image_url == o.image_url &&
+          link_url == o.link_url &&
+          headline == o.headline &&
+          description == o.description &&
+          call_to_action == o.call_to_action
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [image_url, link_url, headline, description, call_to_action].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -248,6 +248,7 @@ require 'zernio-sdk/models/create_standalone_ad_request'
 require 'zernio-sdk/models/create_standalone_ad_request_attribution_spec_inner'
 require 'zernio-sdk/models/create_standalone_ad_request_behaviors_inner'
 require 'zernio-sdk/models/create_standalone_ad_request_brand_identity'
+require 'zernio-sdk/models/create_standalone_ad_request_carousel_cards_inner'
 require 'zernio-sdk/models/create_standalone_ad_request_cities_inner'
 require 'zernio-sdk/models/create_standalone_ad_request_creatives_inner'
 require 'zernio-sdk/models/create_standalone_ad_request_creatives_inner_video'

data/openapi.yaml

@@ -33272,6 +33272,10 @@ paths:
         - { name: level, in: query, schema: { type: string, enum: [ad, adset, campaign, account] }, description: Row granularity }
         - { name: fields, in: query, schema: { type: string }, description: "Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set." }
         - { name: breakdowns, in: query, schema: { type: string }, description: "Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform)." }
+        - { name: actionBreakdowns, in: query, schema: { type: string }, description: "Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row." }
+        - { name: actionAttributionWindows, in: query, schema: { type: string }, description: "Comma-separated Meta attribution windows. Action values are returned keyed per window." }
+        - { name: actionReportTime, in: query, schema: { type: string }, description: "When actions are counted: impression, conversion or mixed." }
+        - { name: useUnifiedAttributionSetting, in: query, schema: { type: boolean }, description: "Use the ad sets' own attribution settings for action counting." }
         - { name: filtering, in: query, schema: { type: string }, description: "JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta." }
         - { name: datePreset, in: query, schema: { type: string }, description: "Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate." }
         - { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of range (YYYY-MM-DD); requires toDate." }
@@ -33325,6 +33329,13 @@ paths:
                 level: { type: string, enum: [ad, adset, campaign, account] }
                 fields: { type: string, description: "Comma-separated Graph insights fields." }
                 breakdowns: { type: string, description: "Comma-separated Graph breakdowns." }
+                actionBreakdowns: { type: string, description: "Comma-separated Graph action breakdowns (e.g. action_type,action_destination)." }
+                actionAttributionWindows:
+                  type: array
+                  items: { type: string }
+                  description: "Meta attribution windows (e.g. [\"7d_click\", \"1d_view\"]). Action values are returned keyed per window."
+                actionReportTime: { type: string, description: "When actions are counted: impression, conversion or mixed." }
+                useUnifiedAttributionSetting: { type: boolean, description: "Use the ad sets' own attribution settings for action counting." }
                 filtering:
                   type: array
                   description: "Meta filter objects, applied server-side."
@@ -34517,6 +34528,27 @@ paths:
                       enum: [SINGLE_IMAGE, CAROUSEL_IMAGE]
                       default: SINGLE_IMAGE
                       description: "Asset-feed ad format. Defaults to SINGLE_IMAGE."
+                carouselCards:
+                  type: array
+                  minItems: 2
+                  maxItems: 10
+                  description: |
+                    Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+                    the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
+                    you control the card order and per-card copy/link. Requires top-level `body`,
+                    `linkUrl` and `callToAction`.
+                    Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`,
+                    `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal
+                    `catalog_sales`.
+                  items:
+                    type: object
+                    required: [imageUrl]
+                    properties:
+                      imageUrl: { type: string, format: uri, description: "Card image; uploaded to the ad account and referenced by hash." }
+                      linkUrl: { type: string, format: uri, description: "Card destination URL. Defaults to the top-level linkUrl." }
+                      headline: { type: string, maxLength: 255, description: "Card headline, shown below the card image." }
+                      description: { type: string, maxLength: 255, description: "Card description, shown under the headline." }
+                      callToAction: { type: string, description: "Card CTA override. Defaults to the top-level callToAction; same enum." }
                 placementAssets:
                   type: object
                   description: |

data/spec/api/ads_api_spec.rb

@@ -558,6 +558,10 @@ describe 'AdsApi' do
   # @option opts [String] :level Row granularity
   # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta'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' own attribution settings for action counting.
   # @option opts [String] :filtering JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. 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.

data/spec/models/create_ad_insights_report_request_spec.rb

@@ -61,6 +61,30 @@ describe Zernio::CreateAdInsightsReportRequest do
     end
   end
 
+  describe 'test attribute "action_breakdowns"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "action_attribution_windows"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "action_report_time"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "use_unified_attribution_setting"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "filtering"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/create_standalone_ad_request_carousel_cards_inner_spec.rb

@@ -0,0 +1,60 @@
+=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 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::CreateStandaloneAdRequestCarouselCardsInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::CreateStandaloneAdRequestCarouselCardsInner do
+  #let(:instance) { Zernio::CreateStandaloneAdRequestCarouselCardsInner.new }
+
+  describe 'test an instance of CreateStandaloneAdRequestCarouselCardsInner' do
+    it 'should create an instance of CreateStandaloneAdRequestCarouselCardsInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::CreateStandaloneAdRequestCarouselCardsInner)
+    end
+  end
+
+  describe 'test attribute "image_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "link_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "headline"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "description"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "call_to_action"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/create_standalone_ad_request_spec.rb

@@ -373,6 +373,12 @@ describe Zernio::CreateStandaloneAdRequest do
     end
   end
 
+  describe 'test attribute "carousel_cards"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "placement_assets"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.528
+  version: 0.0.529
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -307,6 +307,7 @@ files:
 - docs/CreateStandaloneAdRequestAttributionSpecInner.md
 - docs/CreateStandaloneAdRequestBehaviorsInner.md
 - docs/CreateStandaloneAdRequestBrandIdentity.md
+- docs/CreateStandaloneAdRequestCarouselCardsInner.md
 - docs/CreateStandaloneAdRequestCitiesInner.md
 - docs/CreateStandaloneAdRequestCreativesInner.md
 - docs/CreateStandaloneAdRequestCreativesInnerVideo.md
@@ -1825,6 +1826,7 @@ files:
 - lib/zernio-sdk/models/create_standalone_ad_request_attribution_spec_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_behaviors_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_brand_identity.rb
+- lib/zernio-sdk/models/create_standalone_ad_request_carousel_cards_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_cities_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_creatives_inner.rb
 - lib/zernio-sdk/models/create_standalone_ad_request_creatives_inner_video.rb
@@ -3296,6 +3298,7 @@ files:
 - spec/models/create_standalone_ad_request_attribution_spec_inner_spec.rb
 - spec/models/create_standalone_ad_request_behaviors_inner_spec.rb
 - spec/models/create_standalone_ad_request_brand_identity_spec.rb
+- spec/models/create_standalone_ad_request_carousel_cards_inner_spec.rb
 - spec/models/create_standalone_ad_request_cities_inner_spec.rb
 - spec/models/create_standalone_ad_request_creatives_inner_spec.rb
 - spec/models/create_standalone_ad_request_creatives_inner_video_spec.rb
@@ -5671,6 +5674,7 @@ test_files:
 - spec/models/get_you_tube_demographics412_response_scope_status_spec.rb
 - spec/models/update_google_business_location_details_request_categories_additional_categories_inner_spec.rb
 - spec/models/update_workflow_request_spec.rb
+- spec/models/create_standalone_ad_request_carousel_cards_inner_spec.rb
 - spec/models/validate_phone_number_kyc_address_request_spec.rb
 - spec/models/sync_external_posts200_response_synced_spec.rb
 - spec/models/create_account_group201_response_group_spec.rb