zernio-sdk 0.0.824 → 0.0.826

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3974fc48d9a3bda964506f69cf17fb0bf0ac48157b5dbcddb89d32383441d991
-  data.tar.gz: 29b7c41d40f85cd7359848a22ec3e57b877a364980bcaf92b978a34e6dc78d35
+  metadata.gz: 5294c926122620e2a54e3dcd1d08b004699cb23179f674fe312a214db225fd03
+  data.tar.gz: 415ea783c41fb587589db032e52fb733ffb66a1e1e023586684a0b4ba476a64e
 SHA512:
-  metadata.gz: 973d71e10cf8eb8f4703cc2f5dbf24b00fa8a9d5cf61fb97352da2e8dcabbe41333ca92b45e1d842d8340f0358646928f61f0dcfd5092b2e41167b2a2c0e99e8
-  data.tar.gz: d4f715f124e3a6d7fd1ff3d8b6f9df77d2a95db5f589e071cf8ae6ef8f7a7d239d5fd1d1187e43eb4afc4f97b4f5b2eb91e6aa5674089b2657e3a7611245eb77
+  metadata.gz: 37e55b6ee6cf96370c972dd3e7ec43402e637e8e116c31be058c0ccea60dc79719e83c49aad3829be0623edcef18343a63971bc83aa70bccd012ec216fc13918
+  data.tar.gz: b11196d939f62042e0c3e7cf5dec85d743e389beaeee46611c9150e7090d9f959e9beaf322b3fe91b32e35d1f69fcc996a14709b34156248a3c296e851421abb

data/docs/CreateStandaloneAdRequest.md

@@ -28,7 +28,10 @@
 | **headline** | **String** | Required for Meta, Google, Pinterest, LinkedIn, and OpenAI Ads on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400, OpenAI=50 (min 3). On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title. On OpenAI Ads this is the chat card's title. | [optional] |
 | **long_headline** | **String** | Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided. | [optional] |
 | **body** | **String** | Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). On OpenAI Ads this is the chat card's body text. Max: Google=90, Pinterest=500, OpenAI=100. | [optional] |
-| **description** | **String** | Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead. | [optional] |
+| **description** | **String** | Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use `descriptions` (array) instead. | [optional] |
+| **bodies** | **Array<String>** | Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one). Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level `body` field is used as the `object_story_spec.link_data.message` (the preview text) and `headlines` must also be present. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.  | [optional] |
+| **headlines** | **Array<String>** | Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`. The top-level `headline` field is used as the `object_story_spec.link_data.name`.  | [optional] |
+| **descriptions** | **Array<String>** | Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`. | [optional] |
 | **call_to_action** | **String** | Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter. | [optional] |
 | **link_url** | **String** | Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. Required for OpenAI Ads (the chat card's target_url). | [optional] |
 | **lead_gen_form_id** | **String** | Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads. | [optional] |
@@ -129,6 +132,9 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   long_headline: null,
   body: null,
   description: null,
+  bodies: null,
+  headlines: null,
+  descriptions: null,
   call_to_action: null,
   link_url: null,
   lead_gen_form_id: null,

data/docs/InstagramPlatformData.md

@@ -17,6 +17,10 @@
 | **instagram_thumbnail** | **String** | Custom cover image URL for Instagram Reels (JPG or PNG, publicly accessible). Overrides thumbOffset when provided. Also accepted as reelCover (alias). | [optional] |
 | **reel_cover** | **String** | Alias for instagramThumbnail. If both are provided, instagramThumbnail takes priority. | [optional] |
 | **is_ai_generated** | **Boolean** | When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels. | [optional][default to false] |
+| **is_paid_partnership** | **Boolean** | When true, Instagram shows the \"Paid partnership\" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set. | [optional][default to false] |
+| **branded_content_sponsors** | **Array<String>** | Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as \"Paid partnership with @brand\" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership. | [optional] |
+| **comments_enabled** | **Boolean** | When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on. | [optional][default to true] |
+| **location_id** | **String** | Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time. | [optional] |
 
 ## Example
 
@@ -36,7 +40,11 @@ instance = Zernio::InstagramPlatformData.new(
   thumb_offset: 5000,
   instagram_thumbnail: null,
   reel_cover: null,
-  is_ai_generated: null
+  is_ai_generated: null,
+  is_paid_partnership: true,
+  branded_content_sponsors: [nike, 17841400000000000],
+  comments_enabled: false,
+  location_id: 105890561436614
 )
 ```
 

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

@@ -83,9 +83,18 @@ module Zernio
     # Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). On OpenAI Ads this is the chat card's body text. Max: Google=90, Pinterest=500, OpenAI=100.
     attr_accessor :body
 
-    # Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead.
+    # Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use `descriptions` (array) instead.
     attr_accessor :description
 
+    # Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one). Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level `body` field is used as the `object_story_spec.link_data.message` (the preview text) and `headlines` must also be present. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. 
+    attr_accessor :bodies
+
+    # Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`. The top-level `headline` field is used as the `object_story_spec.link_data.name`. 
+    attr_accessor :headlines
+
+    # Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.
+    attr_accessor :descriptions
+
     # Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
     attr_accessor :call_to_action
 
@@ -330,6 +339,9 @@ module Zernio
         :'long_headline' => :'longHeadline',
         :'body' => :'body',
         :'description' => :'description',
+        :'bodies' => :'bodies',
+        :'headlines' => :'headlines',
+        :'descriptions' => :'descriptions',
         :'call_to_action' => :'callToAction',
         :'link_url' => :'linkUrl',
         :'lead_gen_form_id' => :'leadGenFormId',
@@ -439,6 +451,9 @@ module Zernio
         :'long_headline' => :'String',
         :'body' => :'String',
         :'description' => :'String',
+        :'bodies' => :'Array<String>',
+        :'headlines' => :'Array<String>',
+        :'descriptions' => :'Array<String>',
         :'call_to_action' => :'String',
         :'link_url' => :'String',
         :'lead_gen_form_id' => :'String',
@@ -642,6 +657,24 @@ module Zernio
         self.description = attributes[:'description']
       end
 
+      if attributes.key?(:'bodies')
+        if (value = attributes[:'bodies']).is_a?(Array)
+          self.bodies = value
+        end
+      end
+
+      if attributes.key?(:'headlines')
+        if (value = attributes[:'headlines']).is_a?(Array)
+          self.headlines = value
+        end
+      end
+
+      if attributes.key?(:'descriptions')
+        if (value = attributes[:'descriptions']).is_a?(Array)
+          self.descriptions = value
+        end
+      end
+
       if attributes.key?(:'call_to_action')
         self.call_to_action = attributes[:'call_to_action']
       end
@@ -1024,6 +1057,30 @@ module Zernio
         invalid_properties.push('invalid value for "description", the character length must be smaller than or equal to 255.')
       end
 
+      if !@bodies.nil? && @bodies.length > 5
+        invalid_properties.push('invalid value for "bodies", number of items must be less than or equal to 5.')
+      end
+
+      if !@bodies.nil? && @bodies.length < 1
+        invalid_properties.push('invalid value for "bodies", number of items must be greater than or equal to 1.')
+      end
+
+      if !@headlines.nil? && @headlines.length > 5
+        invalid_properties.push('invalid value for "headlines", number of items must be less than or equal to 5.')
+      end
+
+      if !@headlines.nil? && @headlines.length < 1
+        invalid_properties.push('invalid value for "headlines", number of items must be greater than or equal to 1.')
+      end
+
+      if !@descriptions.nil? && @descriptions.length > 5
+        invalid_properties.push('invalid value for "descriptions", number of items must be less than or equal to 5.')
+      end
+
+      if !@descriptions.nil? && @descriptions.length < 1
+        invalid_properties.push('invalid value for "descriptions", number of items must be greater than or equal to 1.')
+      end
+
       if !@creatives.nil? && @creatives.length < 1
         invalid_properties.push('invalid value for "creatives", number of items must be greater than or equal to 1.')
       end
@@ -1141,6 +1198,12 @@ module Zernio
       return false if !@currency.nil? && @currency.to_s.length < 3
       return false if !@long_headline.nil? && @long_headline.to_s.length > 90
       return false if !@description.nil? && @description.to_s.length > 255
+      return false if !@bodies.nil? && @bodies.length > 5
+      return false if !@bodies.nil? && @bodies.length < 1
+      return false if !@headlines.nil? && @headlines.length > 5
+      return false if !@headlines.nil? && @headlines.length < 1
+      return false if !@descriptions.nil? && @descriptions.length > 5
+      return false if !@descriptions.nil? && @descriptions.length < 1
       call_to_action_validator = EnumAttributeValidator.new('String', ["LEARN_MORE", "SHOP_NOW", "SIGN_UP", "BOOK_TRAVEL", "CONTACT_US", "DOWNLOAD", "GET_OFFER", "GET_QUOTE", "SUBSCRIBE", "WATCH_MORE", "ADD_TO_CART", "APPLY_NOW", "BOOK_NOW", "BUY_TICKETS", "DONATE", "DONATE_NOW", "GET_DIRECTIONS", "GET_SHOWTIMES", "LISTEN_NOW", "ORDER_NOW", "PLAY_GAME", "REQUEST_TIME", "SEE_MENU", "START_ORDER", "INSTALL_MOBILE_APP", "USE_APP", "REGISTER", "JOIN", "ATTEND", "REQUEST_DEMO", "VIEW_QUOTE", "APPLY", "SEE_MORE", "BUY_NOW"])
       return false unless call_to_action_validator.valid?(@call_to_action)
       return false if !@creatives.nil? && @creatives.length < 1
@@ -1369,6 +1432,60 @@ module Zernio
       @description = description
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] bodies Value to be assigned
+    def bodies=(bodies)
+      if bodies.nil?
+        fail ArgumentError, 'bodies cannot be nil'
+      end
+
+      if bodies.length > 5
+        fail ArgumentError, 'invalid value for "bodies", number of items must be less than or equal to 5.'
+      end
+
+      if bodies.length < 1
+        fail ArgumentError, 'invalid value for "bodies", number of items must be greater than or equal to 1.'
+      end
+
+      @bodies = bodies
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] headlines Value to be assigned
+    def headlines=(headlines)
+      if headlines.nil?
+        fail ArgumentError, 'headlines cannot be nil'
+      end
+
+      if headlines.length > 5
+        fail ArgumentError, 'invalid value for "headlines", number of items must be less than or equal to 5.'
+      end
+
+      if headlines.length < 1
+        fail ArgumentError, 'invalid value for "headlines", number of items must be greater than or equal to 1.'
+      end
+
+      @headlines = headlines
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] descriptions Value to be assigned
+    def descriptions=(descriptions)
+      if descriptions.nil?
+        fail ArgumentError, 'descriptions cannot be nil'
+      end
+
+      if descriptions.length > 5
+        fail ArgumentError, 'invalid value for "descriptions", number of items must be less than or equal to 5.'
+      end
+
+      if descriptions.length < 1
+        fail ArgumentError, 'invalid value for "descriptions", number of items must be greater than or equal to 1.'
+      end
+
+      @descriptions = descriptions
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] call_to_action Object to be assigned
     def call_to_action=(call_to_action)
@@ -1674,6 +1791,9 @@ module Zernio
           long_headline == o.long_headline &&
           body == o.body &&
           description == o.description &&
+          bodies == o.bodies &&
+          headlines == o.headlines &&
+          descriptions == o.descriptions &&
           call_to_action == o.call_to_action &&
           link_url == o.link_url &&
           lead_gen_form_id == o.lead_gen_form_id &&
@@ -1753,7 +1873,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, buying_type, rf_prediction_id, creative_features, multi_advertiser, validate_only, budget_amount, budget_type, status, campaign_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, work_positions, work_employers, work_industries, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, end_date, start_date, instagram_account_id, dynamic_creative, carousel_cards, default_locale, translations, placement_assets, audience_id, campaign_type, keywords, negative_keywords, additional_headlines, additional_descriptions, sitelinks, callouts, structured_snippets, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, value_rule_set_id, value_rules_applied, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, smart_plus, promoted_object].hash
+      [account_id, ad_account_id, name, campaign_name, ad_set_name, ad_name, tracking, goal, optimization_goal, billing_event, buying_type, rf_prediction_id, creative_features, multi_advertiser, validate_only, budget_amount, budget_type, status, campaign_status, budget_level, currency, headline, long_headline, body, description, bodies, headlines, descriptions, 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, work_positions, work_employers, work_industries, income_tier, languages, placements, saved_targeting_id, raw_targeting, special_ad_categories, special_ad_category_country, regional_regulated_categories, regional_regulation_identities, end_date, start_date, instagram_account_id, dynamic_creative, carousel_cards, default_locale, translations, placement_assets, audience_id, campaign_type, keywords, negative_keywords, additional_headlines, additional_descriptions, sitelinks, callouts, structured_snippets, advantage_audience, attribution_spec, gender, bid_strategy, bid_amount, roas_average_floor, value_rule_set_id, value_rules_applied, platform_specific_data, dsa_beneficiary, dsa_payor, brand_identity, identity_type, smart_plus, promoted_object].hash
     end
 
     # Builds the object from hash

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

@@ -53,6 +53,18 @@ module Zernio
     # When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels.
     attr_accessor :is_ai_generated
 
+    # When true, Instagram shows the \"Paid partnership\" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set.
+    attr_accessor :is_paid_partnership
+
+    # Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as \"Paid partnership with @brand\" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership.
+    attr_accessor :branded_content_sponsors
+
+    # When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on.
+    attr_accessor :comments_enabled
+
+    # Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time.
+    attr_accessor :location_id
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -90,7 +102,11 @@ module Zernio
         :'thumb_offset' => :'thumbOffset',
         :'instagram_thumbnail' => :'instagramThumbnail',
         :'reel_cover' => :'reelCover',
-        :'is_ai_generated' => :'isAiGenerated'
+        :'is_ai_generated' => :'isAiGenerated',
+        :'is_paid_partnership' => :'isPaidPartnership',
+        :'branded_content_sponsors' => :'brandedContentSponsors',
+        :'comments_enabled' => :'commentsEnabled',
+        :'location_id' => :'locationId'
       }
     end
 
@@ -119,7 +135,11 @@ module Zernio
         :'thumb_offset' => :'Integer',
         :'instagram_thumbnail' => :'String',
         :'reel_cover' => :'String',
-        :'is_ai_generated' => :'Boolean'
+        :'is_ai_generated' => :'Boolean',
+        :'is_paid_partnership' => :'Boolean',
+        :'branded_content_sponsors' => :'Array<String>',
+        :'comments_enabled' => :'Boolean',
+        :'location_id' => :'String'
       }
     end
 
@@ -206,6 +226,28 @@ module Zernio
       else
         self.is_ai_generated = false
       end
+
+      if attributes.key?(:'is_paid_partnership')
+        self.is_paid_partnership = attributes[:'is_paid_partnership']
+      else
+        self.is_paid_partnership = false
+      end
+
+      if attributes.key?(:'branded_content_sponsors')
+        if (value = attributes[:'branded_content_sponsors']).is_a?(Array)
+          self.branded_content_sponsors = value
+        end
+      end
+
+      if attributes.key?(:'comments_enabled')
+        self.comments_enabled = attributes[:'comments_enabled']
+      else
+        self.comments_enabled = true
+      end
+
+      if attributes.key?(:'location_id')
+        self.location_id = attributes[:'location_id']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -217,6 +259,15 @@ module Zernio
         invalid_properties.push('invalid value for "thumb_offset", must be greater than or equal to 0.')
       end
 
+      if !@branded_content_sponsors.nil? && @branded_content_sponsors.length > 2
+        invalid_properties.push('invalid value for "branded_content_sponsors", number of items must be less than or equal to 2.')
+      end
+
+      pattern = Regexp.new(/^[0-9]+$/)
+      if !@location_id.nil? && @location_id !~ pattern
+        invalid_properties.push("invalid value for \"location_id\", must conform to the pattern #{pattern}.")
+      end
+
       invalid_properties
     end
 
@@ -227,6 +278,8 @@ module Zernio
       content_type_validator = EnumAttributeValidator.new('String', ["story"])
       return false unless content_type_validator.valid?(@content_type)
       return false if !@thumb_offset.nil? && @thumb_offset < 0
+      return false if !@branded_content_sponsors.nil? && @branded_content_sponsors.length > 2
+      return false if !@location_id.nil? && @location_id !~ Regexp.new(/^[0-9]+$/)
       true
     end
 
@@ -254,6 +307,35 @@ module Zernio
       @thumb_offset = thumb_offset
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] branded_content_sponsors Value to be assigned
+    def branded_content_sponsors=(branded_content_sponsors)
+      if branded_content_sponsors.nil?
+        fail ArgumentError, 'branded_content_sponsors cannot be nil'
+      end
+
+      if branded_content_sponsors.length > 2
+        fail ArgumentError, 'invalid value for "branded_content_sponsors", number of items must be less than or equal to 2.'
+      end
+
+      @branded_content_sponsors = branded_content_sponsors
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] location_id Value to be assigned
+    def location_id=(location_id)
+      if location_id.nil?
+        fail ArgumentError, 'location_id cannot be nil'
+      end
+
+      pattern = Regexp.new(/^[0-9]+$/)
+      if location_id !~ pattern
+        fail ArgumentError, "invalid value for \"location_id\", must conform to the pattern #{pattern}."
+      end
+
+      @location_id = location_id
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -271,7 +353,11 @@ module Zernio
           thumb_offset == o.thumb_offset &&
           instagram_thumbnail == o.instagram_thumbnail &&
           reel_cover == o.reel_cover &&
-          is_ai_generated == o.is_ai_generated
+          is_ai_generated == o.is_ai_generated &&
+          is_paid_partnership == o.is_paid_partnership &&
+          branded_content_sponsors == o.branded_content_sponsors &&
+          comments_enabled == o.comments_enabled &&
+          location_id == o.location_id
     end
 
     # @see the `==` method
@@ -283,7 +369,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [content_type, share_to_feed, collaborators, first_comment, trial_params, user_tags, audio_name, audio_configuration, mute_audio, thumb_offset, instagram_thumbnail, reel_cover, is_ai_generated].hash
+      [content_type, share_to_feed, collaborators, first_comment, trial_params, user_tags, audio_name, audio_configuration, mute_audio, thumb_offset, instagram_thumbnail, reel_cover, is_ai_generated, is_paid_partnership, branded_content_sponsors, comments_enabled, location_id].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -5855,6 +5855,27 @@ components:
           type: boolean
           default: false
           description: When true, the post is labeled by Instagram as containing AI-generated media. Per Meta, this self-disclosure label is for AI-generated media, not AI-written captions. Applies to feed posts, Reels, Stories, and carousels.
+        isPaidPartnership:
+          type: boolean
+          default: false
+          description: 'When true, Instagram shows the "Paid partnership" label on the post. Applies to feed posts, Reels, and carousels; not supported on Stories (400). Requires an Instagram account connected via Facebook Login; classic Instagram Login accounts get a 400 (instagram_paid_partnership_requires_facebook_login). Implied when brandedContentSponsors is set.'
+          example: true
+        brandedContentSponsors:
+          type: array
+          maxItems: 2
+          items: { type: string }
+          description: 'Up to 2 brands to tag as sponsors, each an Instagram username (leading @ optional) or a numeric Instagram user ID. Usernames are resolved at publish time via the Business Discovery API on the publishing account; a sponsor that cannot be resolved (private, personal, or nonexistent account) fails the post with a user error naming it. Sponsors must be professional (Business or Creator) accounts. A brand that has pre-approved the creator shows as "Paid partnership with @brand" immediately; otherwise the plain label shows and the brand receives an approval request. Sets isPaidPartnership. Same login and content-type rules as isPaidPartnership.'
+          example: ['nike', '17841400000000000']
+        commentsEnabled:
+          type: boolean
+          default: true
+          description: 'When false, comments are turned off on the post right after it is published (Meta exposes this as comment_enabled on the media object). Applies to feed posts, Reels, and carousels; ignored for Stories, which have no comments. Works with both Instagram connection methods. Best-effort: if the toggle fails after a successful publish, the post still succeeds and stays live with comments on.'
+          example: false
+        locationId:
+          type: string
+          pattern: '^[0-9]+$'
+          description: 'Tags the post with a location. The ID of a Facebook Page that has location data (digits only); it is sent to Instagram as location_id. Applies to feed posts, Reels, and the carousel as a whole; Stories and individual carousel slides are unsupported (a Story with locationId is rejected with a 400). A Page without location data or that does not exist fails the post with a user error at publish time.'
+          example: '105890561436614'
       description: Feed aspect ratio 0.5625-1.91, carousels up to 10 items, stories require media (no captions). User tag coordinates 0.0-1.0 from top-left. Images over 8 MB and videos over platform limits are auto-compressed.
 
     InstagramAudioAsset:
@@ -44593,7 +44614,35 @@ paths:
                 headline: { type: string, description: "Required for Meta, Google, Pinterest, LinkedIn, and OpenAI Ads on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Ignored for TikTok and X/Twitter. Max: Meta=255, Google=30, Pinterest=100, LinkedIn=400, OpenAI=50 (min 3). On LinkedIn this is the ad's headline (the bold text on the creative); for traffic ads it's the link card title. On OpenAI Ads this is the chat card's title." }
                 longHeadline: { type: string, maxLength: 90, description: "Google Display only — defaults to `headline` if omitted. On LinkedIn, reused as the optional secondary description text on traffic (link) ads; omitted if not provided." }
                 body: { type: string, description: "Required on legacy + attach shapes. For X/Twitter this is the tweet text (max 280 chars including a ~24-char URL when `linkUrl` is set). On LinkedIn this is the post commentary (the intro text shown above the ad). On OpenAI Ads this is the chat card's body text. Max: Google=90, Pinterest=500, OpenAI=100." }
-                description: { type: string, maxLength: 255, description: "Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use dynamicCreative.descriptions instead." }
+                description: { type: string, maxLength: 255, description: "Meta only (facebook/instagram). Link description — the secondary text shown below the headline (Meta's link_data.description; on video creatives mapped to video_data.link_description). When omitted, Meta auto-pulls the destination URL's OpenGraph description. Applies on legacy, attach, and placementAssets shapes; for multi-creative use creatives[].description (this field is the shared fallback). For multi-text variations use `descriptions` (array) instead." }
+                bodies:
+                  type: array
+                  minItems: 1
+                  maxItems: 5
+                  items: { type: string }
+                  description: |
+                    Meta only. Multiple Text Options (Advantage+ Flexible Format): supply 1-5 primary-text
+                    variations and Meta optimises delivery across them, WITHOUT enabling full Dynamic Creative
+                    (`dynamicCreative`). Uses `optimization_type: DEGREES_OF_FREEDOM` on the asset feed, so
+                    multiple ads per ad set are allowed (unlike `dynamicCreative` which is limited to one).
+                    Requires `imageUrl` or `video`, `linkUrl`, and `callToAction`. When set, the top-level
+                    `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
+                    `headlines` must also be present. Mutually exclusive with `dynamicCreative`,
+                    `placementAssets`, `carouselCards`, and `creatives[]`.
+                headlines:
+                  type: array
+                  minItems: 1
+                  maxItems: 5
+                  items: { type: string, maxLength: 255 }
+                  description: |
+                    Meta only. Headline variations for Multiple Text Options. Must be sent alongside `bodies`.
+                    The top-level `headline` field is used as the `object_story_spec.link_data.name`.
+                descriptions:
+                  type: array
+                  minItems: 1
+                  maxItems: 5
+                  items: { type: string, maxLength: 255 }
+                  description: 'Meta only. Optional description variations for Multiple Text Options. Sent alongside `bodies` and `headlines`.'
                 callToAction: { type: string, enum: [LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE, ADD_TO_CART, APPLY_NOW, BOOK_NOW, BUY_TICKETS, DONATE, DONATE_NOW, GET_DIRECTIONS, GET_SHOWTIMES, LISTEN_NOW, ORDER_NOW, PLAY_GAME, REQUEST_TIME, SEE_MENU, START_ORDER, INSTALL_MOBILE_APP, USE_APP, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, BUY_NOW], description: "Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter." }
                 linkUrl: { type: string, format: uri, description: "Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description. Required for OpenAI Ads (the chat card's target_url)." }
                 leadGenFormId: { type: string, description: "Lead Gen form ID to attach to the ad's creative. REQUIRED when `goal` is `lead_generation`. Create one via POST /v1/ads/lead-forms. On Meta (facebook/instagram) this is the leadgen_forms ID; the ad set's promoted_object.page_id + LEAD_GENERATION optimization + destination_type ON_AD are derived automatically from the goal. On LinkedIn this is the adForm ID; the creative's `leadgenCallToAction.destination` is set to `urn:li:adForm:{id}` and the campaign objective is set to MAX_LEAD. Forms must be owned by the sponsoredAccount (not the organization) for the URN to resolve. Also required on every Meta ATTACH (`adSetId`) call that targets a lead ad set (the form attaches per-ad; Meta rejects a formless ad in a lead ad set). Both `placementAssets` (per-placement creative) and `dynamicCreative` (multi-text / multi-asset pool, e.g. multiple headlines and primary texts) ARE supported on Meta instant-form lead ads." }

data/spec/models/create_standalone_ad_request_spec.rb

@@ -209,6 +209,24 @@ describe Zernio::CreateStandaloneAdRequest do
     end
   end
 
+  describe 'test attribute "bodies"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "headlines"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "descriptions"' 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/

data/spec/models/instagram_platform_data_spec.rb

@@ -109,4 +109,28 @@ describe Zernio::InstagramPlatformData do
     end
   end
 
+  describe 'test attribute "is_paid_partnership"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "branded_content_sponsors"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "comments_enabled"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "location_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.824
+  version: 0.0.826
 platform: ruby
 authors:
 - OpenAPI-Generator