late-sdk 0.0.920 → 0.0.921

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40e2044e5a7296ed3c98b27ebbe305a8774a0ea47146a6f679d3e31127b2fa11
-  data.tar.gz: dad4e1e52cd622362f1409fd7f4cf66923e9e45edfd7140d77d05372df23d33b
+  metadata.gz: c2aaedfa75a4c777d9f738f8214bb3a852fe60b62381d90f472c94ac56b9682d
+  data.tar.gz: 0cc02bb3b55e4270ccace14ead86a773152db32e9bc107e5a03ad477a369a8b7
 SHA512:
-  metadata.gz: 96c3456acb147bca85978b4f2ca9ac4d9d6003d57f586ffd75f86ca20ae7e7291af33a688efc45e084a876a26eea3031701db20206d4b6172ce11976da4b544d
-  data.tar.gz: 742671702d09b3f84b24be024bd2563289b3ea4c6a6b5951010aa210522882eb50d5dc216c6acc02847f267c3f13ee2447597e052608b548fe3b5de52bd03e86
+  metadata.gz: 10bfc0b0fe29d20fc5c61ead22103f23b978ae65afa4707494d2bb31ed77e484c570542a7c4b67c0e76e01b67d872b05093ced1c1a709229c7e73371e06012ac
+  data.tar.gz: ae57e75a81673466581c38ca7a6357673d1e1af810c22e243ac1a156a9fd76c0baec8fce4a75a723d1b3854de3a7b3b7462a261d482b6f80d2400d6611a0603e

data/docs/CreateStandaloneAdRequest.md

@@ -19,7 +19,7 @@
 | **promotion** | [**MetaPromotion**](MetaPromotion.md) |  | [optional] |
 | **creative_features** | **Hash<String, String>** | Meta only. Applied to each new creative, including standalone and attach shapes. With creatives[], these are defaults; an item replaces the whole feature map, including an empty map. auto_promotion_tag is an enhancement; an explicit offer uses promotion. | [optional] |
 | **multi_advertiser** | **String** | Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key, and Meta rejects it there. | [optional] |
-| **validate_only** | **Boolean** | Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. | [optional] |
+| **validate_only** | **Boolean** | Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. | [optional] |
 | **budget_amount** | **Float** | Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType). | [optional] |
 | **budget_type** | **String** | Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window. | [optional] |
 | **status** | **String** | Google Performance Max accepts PAUSED only and always creates a paused campaign. Meta, TikTok, and LinkedIn: publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused so you can review before they spend. On Meta the pause is held on the campaign this call creates, leaving the ad set and ad switched on, so a single PUT /v1/ads/campaigns/{campaignId}/status with `active` brings the whole thing live. It is held at every level instead when the pause cannot rely on the campaign: `existingCampaignId` (that campaign may be running and is never touched) or `campaignStatus: ACTIVE`. On TikTok the whole campaign > ad group > ad hierarchy stays paused. On LinkedIn the whole campaign group, campaign, and creative hierarchy stays PAUSED (intendedStatus PAUSED on each). | [optional] |
@@ -30,7 +30,7 @@
 | **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 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 `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. On a video creative the copy lands in `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.  | [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. On a video creative the copy lands in `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.  | [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` (`video_data.title` on a video creative).  | [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. | [optional] |

data/docs/CreateStandaloneAdRequestPlacementAssetsRulesInner.md

@@ -7,6 +7,9 @@
 | **image_url** | **String** | Image mode. The image to deliver for this rule's placements. | [optional] |
 | **video_url** | **String** | Video mode. The video to deliver for this rule's placements. | [optional] |
 | **thumbnail_url** | **String** | Video mode (optional). Poster image for this rule's video; auto-generated when omitted. | [optional] |
+| **headline** | **String** | One headline pinned to this rule. Omit to inherit the top-level headline. | [optional] |
+| **body** | **String** | One primary text pinned to this rule. Omit to inherit the top-level body. | [optional] |
+| **description** | **String** | One link description pinned to this rule. Omit to inherit the top-level description. | [optional] |
 | **placements** | [**CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements**](CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements.md) |  |  |
 
 ## Example
@@ -18,6 +21,9 @@ instance = Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInner.new(
   image_url: null,
   video_url: null,
   thumbnail_url: null,
+  headline: null,
+  body: null,
+  description: null,
   placements: null
 )
 ```

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

@@ -55,7 +55,7 @@ module Zernio
     # Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key, and Meta rejects it there.
     attr_accessor :multi_advertiser
 
-    # Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
+    # Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.
     attr_accessor :validate_only
 
     # Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
@@ -88,7 +88,7 @@ module Zernio
     # 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. On a video creative the copy lands in `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. 
+    # 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. On a video creative the copy lands in `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead. 
     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` (`video_data.title` on a video creative). 

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

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed). The same thing Meta Ads Manager produces with \"different creative per placement\", mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one placement-customized ad to an existing ad set, the way to build N per-placement ads sharing one ad set: create the first normally, attach the rest). Cannot be combined with `creatives[]`. Shared copy (headline, body, link, CTA) comes from the top-level single-creative fields since only the asset varies by placement. Each rule's `placements` accepts the same fields as the top-level `placements` object; Meta enforces co-selection rules and returns an actionable error.  Note on text rendering: Meta suppresses primary text and headline on fullscreen placements (Stories and Reels) in actual ad delivery; the fields are accepted and the ad publishes, but the copy is not shown to users. For visible copy on those placements, bake the text into the creative image or video itself.  A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode: `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl` posters; Meta auto-generates when omitted). Exactly one catch-all default is required. 
+  # Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed). The same thing Meta Ads Manager produces with \"different creative per placement\", mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. Deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (mutually exclusive). Works on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one placement-customized ad to an existing ad set, the way to build N per-placement ads sharing one ad set: create the first normally, attach the rest). Cannot be combined with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule can override `headline`, `body` and `description` with one string per field. Omitted fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction` remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`. Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level `placements` object; Meta enforces co-selection rules and returns an actionable error.  Meta controls text rendering by placement and format. Validation accepts these fields but does not prove that every field appears in delivery. Preview the ad; put copy that must always be visible into the image or video itself.  `validateOnly: true` supports all-image placementAssets without uploading or creating anything. Video placement validation remains unsupported because it requires uploads.  A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode: `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl` posters; Meta auto-generates when omitted). Exactly one catch-all default is required. 
   class CreateStandaloneAdRequestPlacementAssets < ApiModelBase
     # Image mode. Catch-all image for any placement no rule matches. Required in image mode (Meta mandates a default rule).
     attr_accessor :default_image_url

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

@@ -24,6 +24,15 @@ module Zernio
     # Video mode (optional). Poster image for this rule's video; auto-generated when omitted.
     attr_accessor :thumbnail_url
 
+    # One headline pinned to this rule. Omit to inherit the top-level headline.
+    attr_accessor :headline
+
+    # One primary text pinned to this rule. Omit to inherit the top-level body.
+    attr_accessor :body
+
+    # One link description pinned to this rule. Omit to inherit the top-level description.
+    attr_accessor :description
+
     attr_accessor :placements
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -32,6 +41,9 @@ module Zernio
         :'image_url' => :'imageUrl',
         :'video_url' => :'videoUrl',
         :'thumbnail_url' => :'thumbnailUrl',
+        :'headline' => :'headline',
+        :'body' => :'body',
+        :'description' => :'description',
         :'placements' => :'placements'
       }
     end
@@ -52,6 +64,9 @@ module Zernio
         :'image_url' => :'String',
         :'video_url' => :'String',
         :'thumbnail_url' => :'String',
+        :'headline' => :'String',
+        :'body' => :'String',
+        :'description' => :'String',
         :'placements' => :'CreateStandaloneAdRequestPlacementAssetsRulesInnerPlacements'
       }
     end
@@ -90,6 +105,18 @@ module Zernio
         self.thumbnail_url = attributes[:'thumbnail_url']
       end
 
+      if attributes.key?(:'headline')
+        self.headline = attributes[:'headline']
+      end
+
+      if attributes.key?(:'body')
+        self.body = attributes[:'body']
+      end
+
+      if attributes.key?(:'description')
+        self.description = attributes[:'description']
+      end
+
       if attributes.key?(:'placements')
         self.placements = attributes[:'placements']
       else
@@ -102,6 +129,26 @@ module Zernio
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      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 !@headline.nil? && @headline.to_s.length < 1
+        invalid_properties.push('invalid value for "headline", the character length must be greater than or equal to 1.')
+      end
+
+      if !@body.nil? && @body.to_s.length < 1
+        invalid_properties.push('invalid value for "body", the character length must be greater than or equal to 1.')
+      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
+
+      if !@description.nil? && @description.to_s.length < 1
+        invalid_properties.push('invalid value for "description", the character length must be greater than or equal to 1.')
+      end
+
       if @placements.nil?
         invalid_properties.push('invalid value for "placements", placements cannot be nil.')
       end
@@ -113,10 +160,65 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if !@headline.nil? && @headline.to_s.length > 255
+      return false if !@headline.nil? && @headline.to_s.length < 1
+      return false if !@body.nil? && @body.to_s.length < 1
+      return false if !@description.nil? && @description.to_s.length > 255
+      return false if !@description.nil? && @description.to_s.length < 1
       return false if @placements.nil?
       true
     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
+
+      if headline.to_s.length < 1
+        fail ArgumentError, 'invalid value for "headline", the character length must be greater than or equal to 1.'
+      end
+
+      @headline = headline
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] body Value to be assigned
+    def body=(body)
+      if body.nil?
+        fail ArgumentError, 'body cannot be nil'
+      end
+
+      if body.to_s.length < 1
+        fail ArgumentError, 'invalid value for "body", the character length must be greater than or equal to 1.'
+      end
+
+      @body = body
+    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
+
+      if description.to_s.length < 1
+        fail ArgumentError, 'invalid value for "description", the character length must be greater than or equal to 1.'
+      end
+
+      @description = description
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] placements Value to be assigned
     def placements=(placements)
@@ -135,6 +237,9 @@ module Zernio
           image_url == o.image_url &&
           video_url == o.video_url &&
           thumbnail_url == o.thumbnail_url &&
+          headline == o.headline &&
+          body == o.body &&
+          description == o.description &&
           placements == o.placements
     end
 
@@ -147,7 +252,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [image_url, video_url, thumbnail_url, placements].hash
+      [image_url, video_url, thumbnail_url, headline, body, description, placements].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.920'
+  VERSION = '0.0.921'
 end

data/openapi.yaml

@@ -51037,7 +51037,7 @@ paths:
                   description: "Meta only. Multi-advertiser ads: whether Meta may show this ad alongside other advertisers' in one unit. Meta auto-enrols since Aug 2024, so send OPT_OUT to leave. It is a top-level creative field, NOT a `creativeFeatures` key, and Meta rejects it there."
                 validateOnly:
                   type: boolean
-                  description: 'Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, existing video.id or existingCreativeId; media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.'
+                  description: 'Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error.'
                 budgetAmount: { type: number, description: "Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents. Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType)." }
                 budgetType: { type: string, enum: [daily, lifetime], description: "Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window." }
                 status:
@@ -51080,7 +51080,7 @@ paths:
                     `body` field is used as the `object_story_spec.link_data.message` (the preview text) and
                     `headlines` must also be present. On a video creative the copy lands in
                     `video_data.message` / `video_data.title` instead of `link_data`. Mutually exclusive
-                    with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`.
+                    with `dynamicCreative`, `placementAssets`, `carouselCards`, and `creatives[]`. For placement-specific copy, use the singular `placementAssets.rules[].body` and `headline` fields instead.
                 headlines:
                   type: array
                   minItems: 1
@@ -51596,20 +51596,36 @@ paths:
                     on the legacy single shape AND the attach shape (`adSetId` + placementAssets adds one
                     placement-customized ad to an existing ad set, the way to build N per-placement ads
                     sharing one ad set: create the first normally, attach the rest). Cannot be combined
-                    with `creatives[]`. Shared copy (headline, body, link,
-                    CTA) comes from the top-level single-creative fields since only the asset varies by
-                    placement. Each rule's `placements` accepts the same fields as the top-level
+                    with `creatives[]` or top-level `bodies`/`headlines`/`descriptions` arrays. Each rule
+                    can override `headline`, `body` and `description` with one string per field. Omitted
+                    fields and unmatched placements use the top-level copy; `linkUrl` and `callToAction`
+                    remain shared. Zernio emits labelled text with `optimization_type: PLACEMENT`.
+                    Multiple text options rotating within a placement are not supported by this input. Each rule's `placements` accepts the same fields as the top-level
                     `placements` object; Meta enforces co-selection rules and returns an actionable error.
 
-                    Note on text rendering: Meta suppresses primary text and headline on fullscreen
-                    placements (Stories and Reels) in actual ad delivery; the fields are accepted and
-                    the ad publishes, but the copy is not shown to users. For visible copy on those
-                    placements, bake the text into the creative image or video itself.
+                    Meta controls text rendering by placement and format. Validation accepts these fields
+                    but does not prove that every field appears in delivery. Preview the ad; put copy that
+                    must always be visible into the image or video itself.
+
+                    `validateOnly: true` supports all-image placementAssets without uploading or creating
+                    anything. Video placement validation remains unsupported because it requires uploads.
 
                     A block is all-image OR all-video, never mixed (Meta's asset_feed_spec carries one ad
                     format). Image mode: `defaultImageUrl` + `rules[].imageUrl`. Video mode:
                     `defaultVideoUrl` + `rules[].videoUrl` (optional `thumbnailUrl`/`defaultThumbnailUrl`
                     posters; Meta auto-generates when omitted). Exactly one catch-all default is required.
+                  example:
+                    defaultImageUrl: 'https://example.com/feed-4x5.jpg'
+                    rules:
+                      - imageUrl: 'https://example.com/feed-4x5.jpg'
+                        headline: 'Build with Zernio'
+                        body: 'Schedule social posts from your app.'
+                        description: 'One API for your social content.'
+                        placements: { publisherPlatforms: [facebook], facebookPositions: [feed] }
+                      - imageUrl: 'https://example.com/story-9x16.jpg'
+                        headline: 'Your next story'
+                        body: 'Bring your social workflow to Zernio.'
+                        placements: { publisherPlatforms: [facebook], facebookPositions: [story, facebook_reels] }
                   required: [rules]
                   properties:
                     defaultImageUrl:
@@ -51645,6 +51661,20 @@ paths:
                             type: string
                             format: uri
                             description: "Video mode (optional). Poster image for this rule's video; auto-generated when omitted."
+                          headline:
+                            type: string
+                            minLength: 1
+                            maxLength: 255
+                            description: "One headline pinned to this rule. Omit to inherit the top-level headline."
+                          body:
+                            type: string
+                            minLength: 1
+                            description: "One primary text pinned to this rule. Omit to inherit the top-level body."
+                          description:
+                            type: string
+                            minLength: 1
+                            maxLength: 255
+                            description: "One link description pinned to this rule. Omit to inherit the top-level description."
                           placements:
                             type: object
                             description: "Placements this asset is pinned to. At least one field must be set (an empty rule is invalid; that role is served by the default asset). Same enums as the top-level `placements` object."

data/spec/models/create_standalone_ad_request_placement_assets_rules_inner_spec.rb

@@ -45,6 +45,24 @@ describe Zernio::CreateStandaloneAdRequestPlacementAssetsRulesInner do
     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 "body"' 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 "placements"' 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: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.920
+  version: 0.0.921
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -6355,7 +6355,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.920.gem
+- zernio-sdk-0.0.921.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: