late-sdk 0.0.899 → 0.0.901

data/docs/AdCreative.md

@@ -4,6 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **headlines** | [**Array<GoogleRsaHeadline>**](GoogleRsaHeadline.md) | Google RSA only. Replaces the complete headline list. No padding or truncation on update. | [optional] |
+| **descriptions** | [**Array<GoogleRsaDescription>**](GoogleRsaDescription.md) | Google RSA only. Replaces the complete description list. No padding or truncation on update. | [optional] |
+| **final_urls** | **Array<String>** | Google RSA only. Replaces final URLs. Omitted lists stay unchanged. | [optional] |
 | **thumbnail_url** | **String** | Primary thumbnail/image URL | [optional] |
 | **image_url** | **String** | Alternative image URL | [optional] |
 | **video_id** | **String** | Meta video ID for VIDEO-type ads. Null for non-video ads. Callers that need an embeddable MP4 can call GET /{videoId}?fields=source with the page access token. | [optional] |
@@ -36,6 +39,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::AdCreative.new(
+  headlines: null,
+  descriptions: null,
+  final_urls: null,
   thumbnail_url: null,
   image_url: null,
   video_id: null,

data/docs/AdTracking.md

@@ -0,0 +1,20 @@
+# Zernio::AdTracking
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **pixel_id** | **String** | Meta Pixel ID to attach for offsite-conversion measurement. | [optional] |
+| **url_tags** | [**Array<UpdateAdTrackingTagsRequestUrlTagsInner>**](UpdateAdTrackingTagsRequestUrlTagsInner.md) | Click-URL params stored on the creative as `url_tags` and returned by GET /v1/ads/{adId}/tracking-tags. App-promotion linkUrl stays byte-identical to promotedObject.objectStoreUrl. Meta dynamic macros ({{ad.id}}, {{campaign.id}}, {{placement}}, ...) are sent through unescaped so Meta expands them; every other character is percent-encoded. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AdTracking.new(
+  pixel_id: null,
+  url_tags: null
+)
+```
+

data/docs/AddAccountCalloutsRequest.md

@@ -4,9 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id owning the Google Ads connection. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id. Only required when the connection has more than one. | [optional] |
-| **callouts** | **Array<String>** | Callout text, 1-25 characters each; up to 20 per request (Google's CalloutAsset limits). |  |
+| **account_id** | **String** | Zernio Google Ads connection id. |  |
+| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **callouts** | **Array<String>** |  |  |
 
 ## Example
 

data/docs/AddAccountSitelinks201Response.md

@@ -0,0 +1,20 @@
+# Zernio::AddAccountSitelinks201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **sitelinks** | [**Array<AddAccountSitelinks201ResponseSitelinksInner>**](AddAccountSitelinks201ResponseSitelinksInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountSitelinks201Response.new(
+  customer_id: null,
+  sitelinks: null
+)
+```
+

data/docs/AddAccountSitelinks201ResponseSitelinksInner.md

@@ -0,0 +1,26 @@
+# Zernio::AddAccountSitelinks201ResponseSitelinksInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **asset_id** | **String** |  | [optional] |
+| **text** | **String** |  | [optional] |
+| **link_url** | **String** |  | [optional] |
+| **description1** | **String** |  | [optional] |
+| **description2** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountSitelinks201ResponseSitelinksInner.new(
+  asset_id: null,
+  text: null,
+  link_url: null,
+  description1: null,
+  description2: null
+)
+```
+

data/docs/AddAccountSitelinksRequest.md

@@ -0,0 +1,22 @@
+# Zernio::AddAccountSitelinksRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio Google Ads connection id. |  |
+| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **sitelinks** | [**Array<GoogleSitelink>**](GoogleSitelink.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountSitelinksRequest.new(
+  account_id: null,
+  customer_id: null,
+  sitelinks: null
+)
+```
+

data/docs/AddAccountStructuredSnippets201Response.md

@@ -0,0 +1,20 @@
+# Zernio::AddAccountStructuredSnippets201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **structured_snippets** | [**Array<AddAccountStructuredSnippets201ResponseStructuredSnippetsInner>**](AddAccountStructuredSnippets201ResponseStructuredSnippetsInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountStructuredSnippets201Response.new(
+  customer_id: null,
+  structured_snippets: null
+)
+```
+

data/docs/AddAccountStructuredSnippets201ResponseStructuredSnippetsInner.md

@@ -0,0 +1,22 @@
+# Zernio::AddAccountStructuredSnippets201ResponseStructuredSnippetsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **asset_id** | **String** |  | [optional] |
+| **header** | **String** |  | [optional] |
+| **values** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountStructuredSnippets201ResponseStructuredSnippetsInner.new(
+  asset_id: null,
+  header: null,
+  values: null
+)
+```
+

data/docs/AddAccountStructuredSnippetsRequest.md

@@ -0,0 +1,22 @@
+# Zernio::AddAccountStructuredSnippetsRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio Google Ads connection id. |  |
+| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **structured_snippets** | [**Array<GoogleStructuredSnippet>**](GoogleStructuredSnippet.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AddAccountStructuredSnippetsRequest.new(
+  account_id: null,
+  customer_id: null,
+  structured_snippets: null
+)
+```
+

data/docs/AttachAdGroupAssets201Response.md

@@ -0,0 +1,24 @@
+# Zernio::AttachAdGroupAssets201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_group_id** | **String** |  | [optional] |
+| **sitelink_asset_resource_names** | **Array<String>** |  | [optional] |
+| **callout_asset_resource_names** | **Array<String>** |  | [optional] |
+| **structured_snippet_asset_resource_names** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::AttachAdGroupAssets201Response.new(
+  ad_group_id: null,
+  sitelink_asset_resource_names: null,
+  callout_asset_resource_names: null,
+  structured_snippet_asset_resource_names: null
+)
+```
+

data/docs/AttachCampaignAssetsRequest.md

@@ -4,11 +4,11 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio Google Ads SocialAccount id. Resolves the customer id + refresh token. |  |
-| **customer_id** | **String** | Numeric Google Ads customer id. Required when the connection has multiple Google Ads accounts; optional (and inferred) when it has only one. | [optional] |
-| **sitelinks** | [**Array<AttachCampaignAssetsRequestSitelinksInner>**](AttachCampaignAssetsRequestSitelinksInner.md) | See POST /v1/ads/create sitelinks, same shape. | [optional] |
+| **account_id** | **String** | Zernio Google Ads connection id. |  |
+| **customer_id** | **String** | Google customer id without dashes. Required when the connection has multiple customers. | [optional] |
+| **sitelinks** | [**Array<GoogleSitelink>**](GoogleSitelink.md) |  | [optional] |
 | **callouts** | **Array<String>** |  | [optional] |
-| **structured_snippets** | [**Array<AttachCampaignAssetsRequestStructuredSnippetsInner>**](AttachCampaignAssetsRequestStructuredSnippetsInner.md) |  | [optional] |
+| **structured_snippets** | [**Array<GoogleStructuredSnippet>**](GoogleStructuredSnippet.md) |  | [optional] |
 
 ## Example
 

data/docs/CreateAdCampaign200Response.md

@@ -0,0 +1,26 @@
+# Zernio::CreateAdCampaign200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **validate_only** | **Boolean** | Always true. | [optional] |
+| **ad_account_id** | **String** |  | [optional] |
+| **campaign_id** | **String** | Empty because no campaign was created. | [optional] |
+| **objective** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateAdCampaign200Response.new(
+  validate_only: null,
+  ad_account_id: null,
+  campaign_id: null,
+  objective: null,
+  status: null
+)
+```
+

data/docs/CreateAdCampaignRequest.md

@@ -8,6 +8,10 @@
 | **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** |  |  |
 | **goal** | **String** | Mapped to the ODAX objective (same mapping as POST /v1/ads/create). |  |
+| **is_skadnetwork_attribution** | **Boolean** | Meta app promotion only. Immutable campaign flag. Set true for iOS 14+ SKAdNetwork campaigns and supply promotedObject.applicationId plus promotedObject.objectStoreUrl. The campaign receives promotedObject only when this flag is true. Cannot be changed on an existing campaign. | [optional] |
+| **promoted_object** | [**AdPromotedObject**](AdPromotedObject.md) |  | [optional] |
+| **buying_type** | **String** | Meta only. SKAdNetwork app promotion requires AUCTION. | [optional] |
+| **validate_only** | **Boolean** | Meta only. Runs campaign validation without creating or persisting a campaign; Idempotency-Key storage is bypassed. Returns HTTP 200 with validateOnly true and status VALIDATED. | [optional] |
 | **special_ad_categories** | **Array<String>** |  | [optional] |
 | **budget_amount** | **Float** | Campaign-level (CBO) 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. Requires budgetType. | [optional] |
 | **budget_type** | **String** |  | [optional] |
@@ -27,6 +31,10 @@ instance = Zernio::CreateAdCampaignRequest.new(
   ad_account_id: null,
   name: null,
   goal: null,
+  is_skadnetwork_attribution: null,
+  promoted_object: null,
+  buying_type: null,
+  validate_only: null,
   special_ad_categories: null,
   budget_amount: null,
   budget_type: null,

data/docs/CreateCallAdRequest.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **creative_features** | **Hash<String, String>** | Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object. | [optional] |
+| **tracking** | [**AdTracking**](AdTracking.md) |  | [optional] |
 | **account_id** | **String** | Facebook or Instagram SocialAccount ID. |  |
 | **ad_account_id** | **String** | Meta ad account ID, e.g. `act_123456789`. |  |
 | **name** | **String** | Ad display name. Used to derive campaign / ad set names. On the multi-creative shape, each ad's Meta name gets a \" #N\" suffix (1-indexed) so Ads Manager shows them as a numbered batch.  |  |
@@ -54,6 +55,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateCallAdRequest.new(
   creative_features: {auto_promotion_tag=OPT_IN},
+  tracking: null,
   account_id: null,
   ad_account_id: null,
   name: null,

data/docs/CreateMessagingAdRequest.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **creative_features** | **Hash<String, String>** | Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object. | [optional] |
+| **tracking** | [**AdTracking**](AdTracking.md) |  | [optional] |
 | **account_id** | **String** | Facebook or Instagram SocialAccount ID. |  |
 | **ad_account_id** | **String** | Meta ad account ID, e.g. `act_123456789`. |  |
 | **name** | **String** | Ad display name. Used to derive campaign / ad set names. On the multi-creative shape, each ad's Meta name gets a \" #N\" suffix (1-indexed) so Ads Manager shows them as a numbered batch.  |  |
@@ -53,6 +54,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CreateMessagingAdRequest.new(
   creative_features: {auto_promotion_tag=OPT_IN},
+  tracking: null,
   account_id: null,
   ad_account_id: null,
   name: null,

data/docs/CreateStandaloneAdRequest.md

@@ -10,7 +10,7 @@
 | **campaign_name** | **String** | Meta only. Exact campaign name. Overrides the default `<name> - Campaign`. | [optional] |
 | **ad_set_name** | **String** | Meta only. Exact ad set name. Overrides the default `<name> - Ad Set`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry.) | [optional] |
 | **ad_name** | **String** | Meta only. Exact ad name (the single-creative ad object's name). Overrides the default, which is `name`. (For per-ad names on the multi-creative shape, set `name` on each `creatives[]` entry instead.) | [optional] |
-| **tracking** | [**CreateStandaloneAdRequestTracking**](CreateStandaloneAdRequestTracking.md) |  | [optional] |
+| **tracking** | [**AdTracking**](AdTracking.md) |  | [optional] |
 | **goal** | **String** | Required on legacy and multi-creative shapes; the attach shape inherits it from the ad set. Available goals vary by platform.  **Meta** - `conversions`: OUTCOME_SALES. Requires `promotedObject.pixelId` and `promotedObject.customEventType` with a commerce event such as PURCHASE or START_TRIAL, or `promotedObject.customConversionId` to optimise against a Custom Conversion, or `customEventType: OTHER` + `customEventStr` to optimise against a pixel custom event. - `lead_conversion`: OUTCOME_LEADS optimizing website pixel leads. Same pixel and event fields, but with a leads-class event such as LEAD, SUBMIT_APPLICATION, SCHEDULE or CONTACT (or `promotedObject.customConversionId` to optimise against a Custom Conversion instead). Meta gates conversion events by objective, so leads-class events are rejected under `conversions`. - `lead_generation`: OUTCOME_LEADS with instant forms. Requires `leadGenFormId`. `promotedObject.pageId` is optional and auto-filled from the connected Page. - `app_promotion`: requires `promotedObject.applicationId` and `promotedObject.objectStoreUrl`. - `catalog_sales`: Advantage+ catalog ads, for example vehicle inventory. Requires `promotedObject.productSetId`, `promotedObject.pixelId` and `promotedObject.customEventType`. Builds a catalog TEMPLATE creative from the copy fields, which may carry template tags like {{product.name}} or {{vehicle.make}}. No imageUrl or video is sent; Meta renders the visuals per catalog item. Discover catalogs via GET /v1/ads/catalogs and product sets via GET /v1/ads/catalogs/{catalogId}/product-sets. Single shape only, no creatives[], adSetId, dynamicCreative or placementAssets. - `page_likes`: Page Likes conversion location under OUTCOME_ENGAGEMENT (destination_type ON_PAGE, optimization PAGE_LIKES). `promotedObject.pageId` is optional and auto-filled from the connected Page. The creative CTA is fixed to LIKE_PAGE targeting that Page; headline / body / linkUrl / callToAction / imageUrl / video are all optional (Meta derives the link and the Like button from the Page).  **TikTok** - `conversions`: website-conversion ad group. Requires `promotedObject.pixelId`, your TikTok Pixel ID. Accepts an optional `promotedObject.customEventType` with a TikTok optimization_event code your pixel tracks (newer pixels use e.g. SHOPPING for purchase events; legacy pixels use ON_WEB_ORDER, INITIATE_ORDER, ON_WEB_REGISTER or FORM). To inherit pixel and event from an existing ad group, pass `adSetId` instead.  **LinkedIn** - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`. - `lead_generation`: requires `leadGenFormId` (an adForm ID from POST /v1/ads/lead-forms). The campaign objective is set to MAX_LEAD and the creative's `leadgenCallToAction` destination is set to `urn:li:adForm:{id}`. - `job_applicants` requires a `platformSpecificData.jobs` creative. - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.  **OpenAI Ads** - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.  | [optional] |
 | **optimization_goal** | **String** | Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations. | [optional] |
 | **billing_event** | **String** | Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal. | [optional] |
@@ -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** | Meta only, single standalone shape only (no creatives[], adSetId, or RESERVED). Dry-run: each node runs Meta's execution_options validate_only and NOTHING is created or persisted. Children need real parents, so a fresh tree validates the campaign + creative (the ad set needs its campaign to exist, so pass existingCampaignId to validate it too; the ad itself is never validatable pre-create). A Meta validation failure returns the 400 verbatim; success returns 200 with per-node results instead of an ad. | [optional] |
+| **validate_only** | **Boolean** | Meta only. 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] |
 | **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 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 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** | 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] |
@@ -82,8 +82,8 @@
 | **keywords** | [**Array<KeywordEntry>**](KeywordEntry.md) | Google Search only. Keywords on the new ad group; entries are strings (BROAD) or { text, matchType }. Editable later via PUT /v1/ads/{adId} targeting.keywords. | [optional] |
 | **negative_keywords** | [**Array<KeywordEntry>**](KeywordEntry.md) | Google Search only; other platforms return 400. Ad-group-level negative keywords on the new ad group. Editable later via PUT /v1/ads/{adId} targeting.negativeKeywords. | [optional] |
 | **campaign_negative_keywords** | [**Array<KeywordEntry>**](KeywordEntry.md) | Google Search only; other platforms return 400. Campaign-level negative keywords (campaign_criterion.negative), created alongside the ad group. Editable later via PUT /v1/ads/campaigns/{campaignId}/negative-keywords. | [optional] |
-| **additional_headlines** | **Array<String>** | Google Search RSA only. Extra headlines. | [optional] |
-| **additional_descriptions** | **Array<String>** | Google Search RSA only. Extra descriptions. | [optional] |
+| **additional_headlines** | [**Array<CreateStandaloneAdRequestAdditionalHeadlinesInner>**](CreateStandaloneAdRequestAdditionalHeadlinesInner.md) | Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. | [optional] |
+| **additional_descriptions** | [**Array<CreateStandaloneAdRequestAdditionalDescriptionsInner>**](CreateStandaloneAdRequestAdditionalDescriptionsInner.md) | Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. | [optional] |
 | **sitelinks** | [**Array<CreateStandaloneAdRequestSitelinksInner>**](CreateStandaloneAdRequestSitelinksInner.md) | Google Search only. Sitelink assets to create and attach at the campaign level. Each entry becomes an Asset (with sitelink_asset + Asset.final_urls) plus a CampaignAsset link (field_type SITELINK). Approval is async: Google reviews assets after creation; poll asset.policy_summary later to read the verdict. Google requires at least two sitelinks to surface them on an ad; four or more is Google's own recommendation for maximum visibility. The response's creative.sitelinks[] echoes each input plus its Google resourceName.  | [optional] |
 | **callouts** | **Array<String>** | Google Search only. Short callout texts (max 25 chars each) that appear as non-clickable annotations under the ad, e.g. \"Free shipping\", \"24/7 support\". Each becomes one Asset (`callout_asset`) plus a CampaignAsset link with field_type CALLOUT. Response's creative.callouts[] echoes each input plus its Google resourceName.  | [optional] |
 | **structured_snippets** | [**Array<CreateStandaloneAdRequestStructuredSnippetsInner>**](CreateStandaloneAdRequestStructuredSnippetsInner.md) | Google Search only. Structured snippets: one header from Google's predefined list plus 3-10 values (max 25 chars each). Each becomes one Asset (`structured_snippet_asset`) plus a CampaignAsset link with field_type STRUCTURED_SNIPPET.  | [optional] |
@@ -102,7 +102,11 @@
 | **brand_identity** | [**CreateStandaloneAdRequestBrandIdentity**](CreateStandaloneAdRequestBrandIdentity.md) |  | [optional] |
 | **identity_type** | **String** | TikTok only. Forces the identity attribution on the ad:    - `TT_USER`: the posting account's open_id (real @username     branding). Requires a connected TikTok posting account     on the same profile.   - `CUSTOMIZED_USER`: synthetic Brand Identity (display     name + avatar). Requires a configured Brand Identity     (cached on the `tiktokads` SocialAccount via     `PATCH /v1/connect/tiktok-ads`) or an inline     `brandIdentity` to create one on the fly.  When omitted, defaults to `TT_USER` if a posting account is connected on this profile, else `CUSTOMIZED_USER`. Spark Ads (`POST /v1/ads/boost`) always use `TT_USER` regardless of this field, because TikTok requires the original organic post's author identity for Spark.  | [optional] |
 | **smart_plus** | **Boolean** | TikTok only. Creates the ad as a TikTok Upgraded Smart+ campaign: TikTok automates targeting, bidding and delivery. Supports goals `conversions` (Smart+ Web Conversions), `lead_generation` (Smart+ Lead Generation with a website form on `linkUrl`; TikTok Instant Forms not supported) and `app_promotion` (Smart+ App installs; the ad's destination is the app store, so `linkUrl` is not used). The web goals require `promotedObject.pixelId` AND `promotedObject.customEventType`; `app_promotion` requires `promotedObject.applicationId` instead. Targeting works like on any TikTok ad (defaults to `countries: [\"US\"]` when omitted); TikTok automates delivery within it. The budget lives on the Smart+ campaign (Campaign Budget Optimization); a `lifetime` budget additionally requires `endDate`. Cannot be combined with `adSetId`.  | [optional] |
-| **promoted_object** | [**CreateStandaloneAdRequestPromotedObject**](CreateStandaloneAdRequestPromotedObject.md) |  | [optional] |
+| **user_os** | **Array<String>** | Meta only. Operating systems and version ranges, such as iOS_ver_14.0_and_above or Android. Emitted as user_os. May also be supplied inside targeting. | [optional] |
+| **user_device** | **Array<String>** | Meta only. Device models such as iPhone. Emitted as user_device. May also be supplied inside targeting. | [optional] |
+| **is_skadnetwork_attribution** | **Boolean** | Meta app promotion only. Immutable campaign flag. Set true for iOS 14+ SKAdNetwork campaigns and supply promotedObject.applicationId plus promotedObject.objectStoreUrl. The campaign receives promotedObject only when this flag is true. Cannot be changed on an existing campaign. | [optional] |
+| **campaign_attribution** | **String** | Meta ad-set attribution. Required as SKADNETWORK for iOS 14+ app promotion or a SKAdNetwork campaign. Requires AUCTION buying. Standalone Meta ad-set creation is not supported; use this field on /v1/ads/create. | [optional] |
+| **promoted_object** | [**AdPromotedObject**](AdPromotedObject.md) |  | [optional] |
 
 ## Example
 
@@ -188,8 +192,8 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   keywords: null,
   negative_keywords: null,
   campaign_negative_keywords: null,
-  additional_headlines: null,
-  additional_descriptions: null,
+  additional_headlines: ["Schedule Your Posts",{"text":"Build With Zernio","pinnedField":"HEADLINE_2"}],
+  additional_descriptions: ["Build social publishing into your application.",{"text":"Connect social accounts with one API.","pinnedField":"DESCRIPTION_2"}],
   sitelinks: null,
   callouts: null,
   structured_snippets: null,
@@ -208,6 +212,10 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   brand_identity: null,
   identity_type: null,
   smart_plus: null,
+  user_os: null,
+  user_device: null,
+  is_skadnetwork_attribution: null,
+  campaign_attribution: null,
   promoted_object: null
 )
 ```

data/docs/CreateStandaloneAdRequestAdditionalDescriptionsInner.md

@@ -0,0 +1,49 @@
+# Zernio::CreateStandaloneAdRequestAdditionalDescriptionsInner
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::CreateStandaloneAdRequestAdditionalDescriptionsInner.openapi_one_of
+# =>
+# [
+#   :'GoogleRsaDescription',
+#   :'String'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::CreateStandaloneAdRequestAdditionalDescriptionsInner.build(data)
+# => #<GoogleRsaDescription:0x00007fdd4aab02a0>
+
+Zernio::CreateStandaloneAdRequestAdditionalDescriptionsInner.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `GoogleRsaDescription`
+- `String`
+- `nil` (if no type matches)
+

data/docs/CreateStandaloneAdRequestAdditionalHeadlinesInner.md

@@ -0,0 +1,49 @@
+# Zernio::CreateStandaloneAdRequestAdditionalHeadlinesInner
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::CreateStandaloneAdRequestAdditionalHeadlinesInner.openapi_one_of
+# =>
+# [
+#   :'GoogleRsaHeadline',
+#   :'String'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::CreateStandaloneAdRequestAdditionalHeadlinesInner.build(data)
+# => #<GoogleRsaHeadline:0x00007fdd4aab02a0>
+
+Zernio::CreateStandaloneAdRequestAdditionalHeadlinesInner.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `GoogleRsaHeadline`
+- `String`
+- `nil` (if no type matches)
+

data/docs/CtwaAdRequestBody.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **creative_features** | **Hash<String, String>** | Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object. | [optional] |
+| **tracking** | [**AdTracking**](AdTracking.md) |  | [optional] |
 | **account_id** | **String** | Facebook or Instagram SocialAccount ID. |  |
 | **ad_account_id** | **String** | Meta ad account ID, e.g. `act_123456789`. |  |
 | **name** | **String** | Ad display name. Used to derive campaign / ad set names. On the multi-creative shape, each ad's Meta name gets a \" #N\" suffix (1-indexed) so Ads Manager shows them as a numbered batch.  |  |
@@ -52,6 +53,7 @@ require 'zernio-sdk'
 
 instance = Zernio::CtwaAdRequestBody.new(
   creative_features: {auto_promotion_tag=OPT_IN},
+  tracking: null,
   account_id: null,
   ad_account_id: null,
   name: null,

data/docs/GetAd200Response.md

@@ -5,6 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **ad** | [**Ad**](Ad.md) |  | [optional] |
+| **cached_at** | **Time** | Google RSA details cache timestamp. | [optional] |
+| **stale** | **Boolean** | Whether Google RSA details use the last successful cached response. | [optional] |
 
 ## Example
 
@@ -12,7 +14,9 @@
 require 'zernio-sdk'
 
 instance = Zernio::GetAd200Response.new(
-  ad: null
+  ad: null,
+  cached_at: null,
+  stale: null
 )
 ```
 

data/docs/GetAdComments200ResponseMeta.md

@@ -4,11 +4,14 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **platform** | **String** | Which side these comments are on (same as `placement`). |  |
-| **placement** | **String** | The placement these comments are for, useful when you didn't pass ?placement= and want to know which one you got. |  |
+| **platform** | **String** | Platform of the comments. |  |
+| **placement** | **String** | The placement these comments are for, useful when you didn't pass ?placement= and want to know which one you got. | [optional] |
 | **ad_id** | **String** | Internal Zernio ad ID. |  |
-| **platform_ad_id** | **String** | Meta ad ID. |  |
-| **effective_story_id** | **String** | Underlying post ID the comments belong to. effective_object_story_id for the Facebook side, effective_instagram_media_id for the Instagram side. |  |
+| **platform_ad_id** | **String** | Platform ad ID. | [optional] |
+| **effective_story_id** | **String** | Underlying post ID the comments belong to. effective_object_story_id for the Facebook side, effective_instagram_media_id for the Instagram side. | [optional] |
+| **tiktok_item_id** | **String** | TikTok-only video item ID. Null when the ad and comments do not expose it. | [optional] |
+| **since** | **Date** | TikTok-only resolved start date. | [optional] |
+| **_until** | **Date** | TikTok-only resolved end date. | [optional] |
 | **facebook_account_id** | **String** | Facebook-only. The connected Facebook Page SocialAccount these comments were read through. Pass it as `accountId` (with `effectiveStoryId` as the postId) to /v1/inbox/comments to reply/hide/delete. Null when no connected Page was used (then moderation isn't possible). | [optional] |
 | **instagram_user_id** | **String** | Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id). | [optional] |
 | **instagram_permalink** | **String** | Instagram-only. Public permalink of the boosted IG post (creative.instagram_permalink_url). | [optional] |
@@ -27,6 +30,9 @@ instance = Zernio::GetAdComments200ResponseMeta.new(
   ad_id: null,
   platform_ad_id: null,
   effective_story_id: null,
+  tiktok_item_id: null,
+  since: null,
+  _until: null,
   facebook_account_id: null,
   instagram_user_id: null,
   instagram_permalink: null,

data/docs/GetIosFourteenCampaignLimits200Response.md

@@ -0,0 +1,18 @@
+# Zernio::GetIosFourteenCampaignLimits200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **limits** | [**GetIosFourteenCampaignLimits200ResponseLimits**](GetIosFourteenCampaignLimits200ResponseLimits.md) |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetIosFourteenCampaignLimits200Response.new(
+  limits: null
+)
+```
+

data/docs/GetIosFourteenCampaignLimits200ResponseLimits.md

@@ -0,0 +1,22 @@
+# Zernio::GetIosFourteenCampaignLimits200ResponseLimits
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **campaign_group_limit** | **Float** | Campaign group limit reported by Meta. | [optional] |
+| **campaign_limit** | **Float** | Campaign limit reported by Meta. | [optional] |
+| **campaign_group_limits_details** | **Array<Object>** | Campaign group limit details returned by Meta. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetIosFourteenCampaignLimits200ResponseLimits.new(
+  campaign_group_limit: null,
+  campaign_limit: null,
+  campaign_group_limits_details: null
+)
+```
+

data/docs/GoogleAssetUpdate.md

@@ -0,0 +1,26 @@
+# Zernio::GoogleAssetUpdate
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **asset_resource_name** | **String** | Asset resource name returned by a list operation. Must belong to the selected customer. |  |
+| **sitelink_asset** | [**UpdateAccountSitelinksRequestUpdatesInnerSitelinkAsset**](UpdateAccountSitelinksRequestUpdatesInnerSitelinkAsset.md) |  | [optional] |
+| **final_urls** | **Array<String>** |  | [optional] |
+| **callout_asset** | [**UpdateAccountCalloutsRequestUpdatesInnerCalloutAsset**](UpdateAccountCalloutsRequestUpdatesInnerCalloutAsset.md) |  | [optional] |
+| **structured_snippet_asset** | [**GoogleStructuredSnippet**](GoogleStructuredSnippet.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GoogleAssetUpdate.new(
+  asset_resource_name: null,
+  sitelink_asset: null,
+  final_urls: null,
+  callout_asset: null,
+  structured_snippet_asset: null
+)
+```
+