zernio-sdk 0.0.818 → 0.0.820

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 178d9a86c3ca37d445d083262a0adc5b9ce7efe0ae39acc3b3e04990d9862e48
-  data.tar.gz: 75fd49c2c80b9584e3038d3c991cd1e1cf320dda36a3339e08a54c1be77a3db7
+  metadata.gz: 26df76b6eb6c9ad0862d2ca6e44e517a5c54a9d6410b3bc7f716f2fb6b30d0b0
+  data.tar.gz: 6ef0ac7a7e19b2a7694f783b4bca9bb73a105cbd51309ba52a365ec1c8ab8dbf
 SHA512:
-  metadata.gz: de3ec72370eda4c0ff20d2dbea2f97701d0c431ac722ba9c044ecc1e3e338efc1700db25738aae4473d1c65581720a22680d74107a2e596787a2deadae3c0c9e
-  data.tar.gz: 825357536562f978232dbd8770b831f7752f0487fa7c680f60cda1818dea30774377e2cfb117f848f85d1d0b7e43f0e557c61befc9030c99edb88846b7b615ca
+  metadata.gz: 91590d4cb9c0eff22122efcc24a38eb449c246ed9b8fdc006bfae19aa63f29d739669feaa8010ff2b65ae49c235fa6d9ef4dcd8316eed53d7cc98ebb96b92114
+  data.tar.gz: 1729f074ff854dcd036af00b8d134e7a7b726ce23d00c6c6333cedc01bedeef3696f20ada0a754f82099d4565379a911101cf6044a7b5acab889c2d2db4dfadc

data/docs/AdCampaignsApi.md

@@ -249,7 +249,7 @@ end
 
 Create a standalone campaign
 
-Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
 
 ### Examples
 

data/docs/BoostPostRequest.md

@@ -25,6 +25,7 @@
 | **tracking** | [**BoostPostRequestTracking**](BoostPostRequestTracking.md) |  | [optional] |
 | **special_ad_categories** | **Array<String>** | Meta only. Required for housing, employment, credit, or political ads. | [optional] |
 | **special_ad_category_country** | **Array<String>** | Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise). | [optional] |
+| **regional_regulated_categories** | **Array<String>** | Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set. | [optional] |
 | **link_url** | **String** | Destination URL for the CTA button. Send it together with `callToAction`.  **Meta**: adds a top-level `call_to_action` to the post-reference creative. This is what gives a `traffic` boost a clickable destination without replacing the creative and losing the post's social proof. Ignored when `leadGenFormId` is set, which supplies its own destination. Live-verified against a Page-post creative.  **TikTok**: maps to `landing_page_url` on the Spark Ad creative (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable destination without it.  Ignored on LinkedIn / Pinterest / X / Google, which infer the destination from the boosted post.  | [optional] |
 | **call_to_action** | **String** | CTA button label. Send it together with `linkUrl` — a CTA without a destination produces a button that goes nowhere, so sending one alone is a 400.  **Meta**: the CTA enum of POST /v1/ads/create plus `VIEW_INSTAGRAM_PROFILE`, which is accepted on boost only. For that value `linkUrl` is typically the Instagram profile URL.  **TikTok**: pass-through to `call_to_action` on the Spark Ad creative; the platform validates the value. See TikTok's \"Enumeration - Call-to-Action\".  | [optional] |
 | **spark_auth_code** | **String** | TikTok-only. Spark Code (creator's `auth_code`) authorizing cross-creator Spark Ads — the advertiser can boost a video owned by a DIFFERENT TikTok account. Without this, boosts are limited to videos owned by the same account running the ads (same-BC creators only). The creator generates the code in their TikTok app's Promote settings and shares it with the advertiser. Maps to `auth_code` on the creative entry of /v2/ad/create/.  | [optional] |
@@ -61,6 +62,7 @@ instance = Zernio::BoostPostRequest.new(
   tracking: null,
   special_ad_categories: null,
   special_ad_category_country: null,
+  regional_regulated_categories: null,
   link_url: null,
   call_to_action: null,
   spark_auth_code: null,

data/docs/CreateAdCampaignRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **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). |  |
 | **special_ad_categories** | **Array<String>** |  | [optional] |

data/docs/CreateAdCreativeRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **headline** | **String** |  |  |
 | **body** | **String** | Primary text |  |
 | **description** | **String** | Link description below the headline; omitted = Meta scrapes the destination's OG description. | [optional] |

data/docs/CreateCallAdRequest.md

@@ -38,6 +38,7 @@
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
 | **dsa_beneficiary** | **String** | Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted.  | [optional] |
 | **dsa_payor** | **String** | Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor.  | [optional] |
+| **regional_regulated_categories** | **Array<String>** | Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set. | [optional] |
 | **phone_number** | **String** | E.164 number the CALL_NOW CTA dials (e.g. +34600111222). |  |
 | **link_url** | **String** | Website shown as the creative's link. Required: Meta rejects tel: as link_data.link; the phone number rides only the CTA. |  |
 
@@ -81,6 +82,7 @@ instance = Zernio::CreateCallAdRequest.new(
   roas_average_floor: null,
   dsa_beneficiary: null,
   dsa_payor: null,
+  regional_regulated_categories: null,
   phone_number: null,
   link_url: null
 )

data/docs/CreateCustomConversionRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** | Also the reuse key, together with pixelId. |  |
 | **pixel_id** | **String** | Meta pixel id (event_source_id). From GET /v1/accounts/{accountId}/tracking-tags. |  |
 | **custom_event_type** | **String** | Meta custom_event_type, e.g. LEAD, PURCHASE, OTHER. |  |

data/docs/CreateMessagingAdRequest.md

@@ -38,6 +38,7 @@
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
 | **dsa_beneficiary** | **String** | Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted.  | [optional] |
 | **dsa_payor** | **String** | Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor.  | [optional] |
+| **regional_regulated_categories** | **Array<String>** | Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set. | [optional] |
 | **destination** | **String** | Where the conversation opens when the ad is tapped. |  |
 
 ## Example
@@ -80,6 +81,7 @@ instance = Zernio::CreateMessagingAdRequest.new(
   roas_average_floor: null,
   dsa_beneficiary: null,
   dsa_payor: null,
+  regional_regulated_categories: null,
   destination: null
 )
 ```

data/docs/CreateRfPredictionRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id (posting or ads variant). |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **budget_amount** | **Float** | Whole currency units. Exactly one of budgetAmount / reach. | [optional] |
 | **reach** | **Integer** | Target unique reach. Exactly one of budgetAmount / reach. | [optional] |
 | **start_date** | **Time** | Campaign window start (must be in the future). |  |

data/docs/CreateStandaloneAdRequest.md

@@ -63,6 +63,7 @@
 | **raw_targeting** | **Hash<String, Object>** | Meta only. A raw Meta-native targeting spec (snake_case: `geo_locations`, `age_min`, `excluded_custom_audiences`, `flexible_spec`, `targeting_automation`, `user_os`, `wireless_carrier`, business places, etc.) — exactly the shape `GET /v1/ads/{adId}` returns for external ads. Sent alone it reaches the ad set VERBATIM (the clone-a-campaign's-targeting-exactly path). Meta validates and surfaces any errors.  Can be combined with the camelCase targeting fields (countries/regions/cities/interests/ageMin/..., `targeting`, `savedTargetingId`, `audienceId`): rawTargeting is the BASE layer and the built camelCase spec is merged on top, key by key, with the camelCase side winning on collision (the camelCase precedence chain stays `savedTargetingId` < `targeting` < flat fields). The merge goes one level deep inside `geo_locations` and `excluded_geo_locations`: built sub-keys win, raw-only sub-keys such as `location_types` survive alongside built `countries`. Array values (`flexible_spec`, ...) are replaced as a WHOLE key when the camelCase spec builds them, never element-merged. When rawTargeting is present the defaults the camelCase builder normally injects (US geo, `targeting_automation.advantage_audience: 0`) are suppressed, so raw's values are not clobbered — include `targeting_automation` in the raw spec (or send `advantageAudience`) as Meta requires it on create. If cloning an EU campaign, also pass `dsaBeneficiary` / `dsaPayor` (those are separate fields, not part of targeting).  | [optional] |
 | **special_ad_categories** | **Array<String>** | Meta only. Declares the ad's special category, required for housing, employment, credit, or political/social-issue ads (Meta enforces restricted targeting for these). Note: setting a special category disables income/zip targeting on Meta.  | [optional] |
 | **special_ad_category_country** | **Array<String>** | Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via existingCampaignId (the existing campaign's category/country already governs it).  | [optional] |
+| **regional_regulated_categories** | **Array<String>** | Meta only. Regional regulation categories required when the ad set targets certain countries. Known values: SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV, TAIWAN_FINSERV. Meta rejects the ad set without this when the targeting geo includes the corresponding country.  | [optional] |
 | **end_date** | **Time** | Required for lifetime budgets | [optional] |
 | **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we use the Instagram actor Meta already runs the Page's other ads as, falling back to the Page's page-backed Instagram account. Useful when a Page has more than one eligible IG account.  | [optional] |
@@ -161,6 +162,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   raw_targeting: null,
   special_ad_categories: null,
   special_ad_category_country: null,
+  regional_regulated_categories: null,
   end_date: null,
   start_date: null,
   instagram_account_id: null,

data/docs/CreateValueRuleSetRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **name** | **String** |  |  |
 | **rules** | [**Array<ValueRule>**](ValueRule.md) | Evaluated in order; the first matching rule wins. |  |
 

data/docs/CtwaAdRequestBody.md

@@ -38,6 +38,7 @@
 | **roas_average_floor** | **Float** | Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`; rejected otherwise. Meta enforces its own upper bound server-side.  | [optional] |
 | **dsa_beneficiary** | **String** | Legal entity that benefits from the ad. Required when targeting EU users (EU DSA, Article 26). Optional if the ad account has a default beneficiary: set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta fills it in whenever the field is omitted.  | [optional] |
 | **dsa_payor** | **String** | Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor.  | [optional] |
+| **regional_regulated_categories** | **Array<String>** | Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set. | [optional] |
 
 ## Example
 
@@ -78,7 +79,8 @@ instance = Zernio::CtwaAdRequestBody.new(
   bid_amount: null,
   roas_average_floor: null,
   dsa_beneficiary: null,
-  dsa_payor: null
+  dsa_payor: null,
+  regional_regulated_categories: null
 )
 ```
 

data/docs/GenerateAdPreviewsRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | Zernio SocialAccount id used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **formats** | **Array<String>** | Meta ad_format values, one preview per format. Defaults to [DESKTOP_FEED_STANDARD]. | [optional] |
 | **existing_creative_id** | **String** | Preview an existing ad-account creative by id. Mutually exclusive with creativeSpec. | [optional] |
 | **creative_spec** | **Hash<String, Object>** | Raw Meta creative spec forwarded verbatim to /generatepreviews. Mutually exclusive with existingCreativeId. | [optional] |

data/docs/UpdateAdCreativeRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
 | **name** | **String** |  |  |
 
 ## Example

data/docs/UpdateValueRuleSetRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
 | **name** | **String** | Required: the update replaces the whole set. |  |
 | **rules** | [**Array<ValueRule>**](ValueRule.md) | The COMPLETE rule list. Omitting a rule deletes it on Meta. |  |
 

data/docs/UploadAdImageRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **image_base64** | **String** | Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped). |  |
 | **filename** | **String** | Optional filename shown in Meta's image library. Defaults to ad_image.jpg. | [optional] |
 

data/docs/UploadAdVideoRequest.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token. |  |
-| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created. |  |
+| **ad_account_id** | **String** | Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...). |  |
 | **video_url** | **String** | Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64. | [optional] |
 | **video_base64** | **String** | Raw base64 video bytes, or a full data URL (the data:video/...;base64, prefix is stripped). Capped by Vercel's body limit (~4.5 MB payload). Provide exactly one of videoUrl or videoBase64. | [optional] |
 | **filename** | **String** | Optional filename shown alongside the upload session. Applied only when uploading via videoBase64. | [optional] |

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

@@ -237,7 +237,7 @@ module Zernio
     end
 
     # Create a standalone campaign
-    # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_campaign_request [CreateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
@@ -248,7 +248,7 @@ module Zernio
     end
 
     # Create a standalone campaign
-    # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+    # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
     # @param create_ad_campaign_request [CreateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

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

@@ -72,6 +72,9 @@ module Zernio
     # Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
     attr_accessor :special_ad_category_country
 
+    # Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.
+    attr_accessor :regional_regulated_categories
+
     # Destination URL for the CTA button. Send it together with `callToAction`.  **Meta**: adds a top-level `call_to_action` to the post-reference creative. This is what gives a `traffic` boost a clickable destination without replacing the creative and losing the post's social proof. Ignored when `leadGenFormId` is set, which supplies its own destination. Live-verified against a Page-post creative.  **TikTok**: maps to `landing_page_url` on the Spark Ad creative (`AdcreateCreatives.landing_page_url`); Spark Ads have no clickable destination without it.  Ignored on LinkedIn / Pinterest / X / Google, which infer the destination from the boosted post. 
     attr_accessor :link_url
 
@@ -142,6 +145,7 @@ module Zernio
         :'tracking' => :'tracking',
         :'special_ad_categories' => :'specialAdCategories',
         :'special_ad_category_country' => :'specialAdCategoryCountry',
+        :'regional_regulated_categories' => :'regionalRegulatedCategories',
         :'link_url' => :'linkUrl',
         :'call_to_action' => :'callToAction',
         :'spark_auth_code' => :'sparkAuthCode',
@@ -187,6 +191,7 @@ module Zernio
         :'tracking' => :'BoostPostRequestTracking',
         :'special_ad_categories' => :'Array<String>',
         :'special_ad_category_country' => :'Array<String>',
+        :'regional_regulated_categories' => :'Array<String>',
         :'link_url' => :'String',
         :'call_to_action' => :'String',
         :'spark_auth_code' => :'String',
@@ -318,6 +323,12 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'regional_regulated_categories')
+        if (value = attributes[:'regional_regulated_categories']).is_a?(Array)
+          self.regional_regulated_categories = value
+        end
+      end
+
       if attributes.key?(:'link_url')
         self.link_url = attributes[:'link_url']
       end
@@ -553,6 +564,7 @@ module Zernio
           tracking == o.tracking &&
           special_ad_categories == o.special_ad_categories &&
           special_ad_category_country == o.special_ad_category_country &&
+          regional_regulated_categories == o.regional_regulated_categories &&
           link_url == o.link_url &&
           call_to_action == o.call_to_action &&
           spark_auth_code == o.spark_auth_code &&
@@ -572,7 +584,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [post_id, platform_post_id, account_id, ad_account_id, name, goal, ad_set_id, budget, instagram_account_id, destination_type, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, lead_gen_form_id, status, optimization_goal].hash
+      [post_id, platform_post_id, account_id, ad_account_id, name, goal, ad_set_id, budget, instagram_account_id, destination_type, currency, schedule, targeting, raw_targeting, bid_strategy, bid_amount, roas_average_floor, platform_specific_data, tracking, special_ad_categories, special_ad_category_country, regional_regulated_categories, link_url, call_to_action, spark_auth_code, dsa_beneficiary, dsa_payor, lead_gen_form_id, status, optimization_goal].hash
     end
 
     # Builds the object from hash

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class CreateAdCampaignRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :name

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :headline

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

@@ -111,6 +111,9 @@ module Zernio
     # Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor. 
     attr_accessor :dsa_payor
 
+    # Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.
+    attr_accessor :regional_regulated_categories
+
     # E.164 number the CALL_NOW CTA dials (e.g. +34600111222).
     attr_accessor :phone_number
 
@@ -176,6 +179,7 @@ module Zernio
         :'roas_average_floor' => :'roasAverageFloor',
         :'dsa_beneficiary' => :'dsaBeneficiary',
         :'dsa_payor' => :'dsaPayor',
+        :'regional_regulated_categories' => :'regionalRegulatedCategories',
         :'phone_number' => :'phoneNumber',
         :'link_url' => :'linkUrl'
       }
@@ -228,6 +232,7 @@ module Zernio
         :'roas_average_floor' => :'Float',
         :'dsa_beneficiary' => :'String',
         :'dsa_payor' => :'String',
+        :'regional_regulated_categories' => :'Array<String>',
         :'phone_number' => :'String',
         :'link_url' => :'String'
       }
@@ -420,6 +425,12 @@ module Zernio
         self.dsa_payor = attributes[:'dsa_payor']
       end
 
+      if attributes.key?(:'regional_regulated_categories')
+        if (value = attributes[:'regional_regulated_categories']).is_a?(Array)
+          self.regional_regulated_categories = value
+        end
+      end
+
       if attributes.key?(:'phone_number')
         self.phone_number = attributes[:'phone_number']
       else
@@ -849,6 +860,7 @@ module Zernio
           roas_average_floor == o.roas_average_floor &&
           dsa_beneficiary == o.dsa_beneficiary &&
           dsa_payor == o.dsa_payor &&
+          regional_regulated_categories == o.regional_regulated_categories &&
           phone_number == o.phone_number &&
           link_url == o.link_url
     end
@@ -862,7 +874,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, phone_number, link_url].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, phone_number, link_url].hash
     end
 
     # Builds the object from hash

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class CreateCustomConversionRequest < ApiModelBase
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Also the reuse key, together with pixelId.

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

@@ -111,6 +111,9 @@ module Zernio
     # Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor. 
     attr_accessor :dsa_payor
 
+    # Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.
+    attr_accessor :regional_regulated_categories
+
     # Where the conversation opens when the ad is tapped.
     attr_accessor :destination
 
@@ -173,6 +176,7 @@ module Zernio
         :'roas_average_floor' => :'roasAverageFloor',
         :'dsa_beneficiary' => :'dsaBeneficiary',
         :'dsa_payor' => :'dsaPayor',
+        :'regional_regulated_categories' => :'regionalRegulatedCategories',
         :'destination' => :'destination'
       }
     end
@@ -224,6 +228,7 @@ module Zernio
         :'roas_average_floor' => :'Float',
         :'dsa_beneficiary' => :'String',
         :'dsa_payor' => :'String',
+        :'regional_regulated_categories' => :'Array<String>',
         :'destination' => :'String'
       }
     end
@@ -415,6 +420,12 @@ module Zernio
         self.dsa_payor = attributes[:'dsa_payor']
       end
 
+      if attributes.key?(:'regional_regulated_categories')
+        if (value = attributes[:'regional_regulated_categories']).is_a?(Array)
+          self.regional_regulated_categories = value
+        end
+      end
+
       if attributes.key?(:'destination')
         self.destination = attributes[:'destination']
       else
@@ -825,6 +836,7 @@ module Zernio
           roas_average_floor == o.roas_average_floor &&
           dsa_beneficiary == o.dsa_beneficiary &&
           dsa_payor == o.dsa_payor &&
+          regional_regulated_categories == o.regional_regulated_categories &&
           destination == o.destination
     end
 
@@ -837,7 +849,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, destination].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories, destination].hash
     end
 
     # Builds the object from hash

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id (posting or ads variant).
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Whole currency units. Exactly one of budgetAmount / reach.

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

@@ -183,6 +183,9 @@ module Zernio
     # Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via existingCampaignId (the existing campaign's category/country already governs it). 
     attr_accessor :special_ad_category_country
 
+    # Meta only. Regional regulation categories required when the ad set targets certain countries. Known values: SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV, TAIWAN_FINSERV. Meta rejects the ad set without this when the targeting geo includes the corresponding country. 
+    attr_accessor :regional_regulated_categories
+
     # Required for lifetime budgets
     attr_accessor :end_date
 
@@ -358,6 +361,7 @@ module Zernio
         :'raw_targeting' => :'rawTargeting',
         :'special_ad_categories' => :'specialAdCategories',
         :'special_ad_category_country' => :'specialAdCategoryCountry',
+        :'regional_regulated_categories' => :'regionalRegulatedCategories',
         :'end_date' => :'endDate',
         :'start_date' => :'startDate',
         :'instagram_account_id' => :'instagramAccountId',
@@ -465,6 +469,7 @@ module Zernio
         :'raw_targeting' => :'Hash<String, Object>',
         :'special_ad_categories' => :'Array<String>',
         :'special_ad_category_country' => :'Array<String>',
+        :'regional_regulated_categories' => :'Array<String>',
         :'end_date' => :'Time',
         :'start_date' => :'Time',
         :'instagram_account_id' => :'String',
@@ -800,6 +805,12 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'regional_regulated_categories')
+        if (value = attributes[:'regional_regulated_categories']).is_a?(Array)
+          self.regional_regulated_categories = value
+        end
+      end
+
       if attributes.key?(:'end_date')
         self.end_date = attributes[:'end_date']
       end
@@ -1686,6 +1697,7 @@ module Zernio
           raw_targeting == o.raw_targeting &&
           special_ad_categories == o.special_ad_categories &&
           special_ad_category_country == o.special_ad_category_country &&
+          regional_regulated_categories == o.regional_regulated_categories &&
           end_date == o.end_date &&
           start_date == o.start_date &&
           instagram_account_id == o.instagram_account_id &&
@@ -1729,7 +1741,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, 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, 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, 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/create_value_rule_set_request.rb

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class CreateValueRuleSetRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     attr_accessor :name

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

@@ -112,6 +112,9 @@ module Zernio
     # Legal entity that pays for the ad. Can differ from `dsaBeneficiary` (for example, an agency paying for a client's ads). Same rules as `dsaBeneficiary`: required for EU targeting unless the ad account has a default payor. 
     attr_accessor :dsa_payor
 
+    # Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.
+    attr_accessor :regional_regulated_categories
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -170,7 +173,8 @@ module Zernio
         :'bid_amount' => :'bidAmount',
         :'roas_average_floor' => :'roasAverageFloor',
         :'dsa_beneficiary' => :'dsaBeneficiary',
-        :'dsa_payor' => :'dsaPayor'
+        :'dsa_payor' => :'dsaPayor',
+        :'regional_regulated_categories' => :'regionalRegulatedCategories'
       }
     end
 
@@ -220,7 +224,8 @@ module Zernio
         :'bid_amount' => :'Float',
         :'roas_average_floor' => :'Float',
         :'dsa_beneficiary' => :'String',
-        :'dsa_payor' => :'String'
+        :'dsa_payor' => :'String',
+        :'regional_regulated_categories' => :'Array<String>'
       }
     end
 
@@ -403,6 +408,12 @@ module Zernio
       if attributes.key?(:'dsa_payor')
         self.dsa_payor = attributes[:'dsa_payor']
       end
+
+      if attributes.key?(:'regional_regulated_categories')
+        if (value = attributes[:'regional_regulated_categories']).is_a?(Array)
+          self.regional_regulated_categories = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -790,7 +801,8 @@ module Zernio
           bid_amount == o.bid_amount &&
           roas_average_floor == o.roas_average_floor &&
           dsa_beneficiary == o.dsa_beneficiary &&
-          dsa_payor == o.dsa_payor
+          dsa_payor == o.dsa_payor &&
+          regional_regulated_categories == o.regional_regulated_categories
     end
 
     # @see the `==` method
@@ -802,7 +814,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor].hash
+      [account_id, ad_account_id, name, headline, body, image_url, video, welcome_message, creatives, ad_set_id, budget_amount, budget_type, currency, end_date, countries, cities, regions, zips, metros, custom_locations, age_min, age_max, interests, audience_id, placements, advantage_audience, objective, status, campaign_status, bid_strategy, bid_amount, roas_average_floor, dsa_beneficiary, dsa_payor, regional_regulated_categories].hash
     end
 
     # Builds the object from hash

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

@@ -18,7 +18,7 @@ module Zernio
     # Zernio SocialAccount id used to resolve the Meta token.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Meta ad_format values, one preview per format. Defaults to [DESKTOP_FEED_STANDARD].

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class UpdateAdCreativeRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
     attr_accessor :name

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class UpdateValueRuleSetRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
     # Required: the update replaces the whole set.

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class UploadAdImageRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped).

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class UploadAdVideoRequest < ApiModelBase
-    # Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+    # Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
     attr_accessor :account_id
 
-    # Meta ad account id (act_<n>).
+    # Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
     attr_accessor :ad_account_id
 
     # Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64.

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -1174,6 +1174,10 @@ components:
             (for example, an agency paying for a client's ads). Same rules as
             `dsaBeneficiary`: required for EU targeting unless the ad account has
             a default payor.
+        regionalRegulatedCategories:
+          type: array
+          description: 'Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.'
+          items: { type: string }
     WorkflowNode:
       type: object
       required: [id, type]
@@ -40605,14 +40609,19 @@ paths:
       x-resource-group: "ads"
       operationId: createAdCampaign
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta"]
+      x-platforms: ["meta", "google", "linkedin", "tiktok", "x", "pinterest", "openai"]
       summary: Create a standalone campaign
       description: |-
-        Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it
-        later via `existingCampaignId` on the create endpoints. A budget here is campaign-level
-        (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
-        `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
-        next sync discovery pass.
+        Creates a campaign WITHOUT its first ad set / ad, on the platform of the given
+        `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints.
+        Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it
+        for ABO (each ad set carries its own budget), and `specialAdCategories` /
+        `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget
+        (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the
+        campaign GROUP (our campaign level) and rejects a budget, which lives on the
+        campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are
+        created without a status and report `ENABLE`. Created `PAUSED` unless
+        `status: ACTIVE` where the platform supports it.
 
         **Idempotency:** send an `Idempotency-Key` header to make retries safe.
       security:
@@ -40636,8 +40645,8 @@ paths:
               type: object
               required: [accountId, adAccountId, name, goal]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, maxLength: 255 }
                 goal:
                   type: string
@@ -41955,7 +41964,7 @@ paths:
               required: [accountId, adAccountId]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 formats:
                   type: array
                   minItems: 1
@@ -42722,7 +42731,7 @@ paths:
               required: [accountId, adAccountId, startDate, endDate]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant)." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 budgetAmount: { type: number, description: "Whole currency units. Exactly one of budgetAmount / reach." }
                 reach: { type: integer, description: "Target unique reach. Exactly one of budgetAmount / reach." }
                 startDate: { type: string, format: date-time, description: "Campaign window start (must be in the future)." }
@@ -43096,7 +43105,7 @@ paths:
               required: [accountId, adAccountId, headline, body, linkUrl]
               properties:
                 accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 headline: { type: string, maxLength: 255 }
                 body: { type: string, description: Primary text }
                 description: { type: string, maxLength: 255, description: "Link description below the headline; omitted = Meta scrapes the destination's OG description." }
@@ -43192,7 +43201,7 @@ paths:
               type: object
               required: [accountId, name]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
                 name: { type: string, maxLength: 255 }
       responses:
         '200':
@@ -43335,8 +43344,8 @@ paths:
               type: object
               required: [accountId, adAccountId, name, rules]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, minLength: 1, maxLength: 255 }
                 rules:
                   type: array
@@ -43426,7 +43435,7 @@ paths:
               type: object
               required: [accountId, name, rules]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
                 name: { type: string, minLength: 1, maxLength: 255, description: "Required: the update replaces the whole set." }
                 rules:
                   type: array
@@ -43951,6 +43960,10 @@ paths:
                   type: array
                   description: 'Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).'
                   items: { type: string }
+                regionalRegulatedCategories:
+                  type: array
+                  description: 'Meta only. Regional regulation categories required when the ad set targets certain countries (e.g. SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV, INDIA_FINSERV). Forwarded to the ad set.'
+                  items: { type: string }
                 linkUrl:
                   type: string
                   format: uri
@@ -44488,6 +44501,14 @@ paths:
                     specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via
                     existingCampaignId (the existing campaign's category/country already governs it).
                   items: { type: string }
+                regionalRegulatedCategories:
+                  type: array
+                  description: |
+                    Meta only. Regional regulation categories required when the ad set targets certain countries.
+                    Known values: SINGAPORE_UNIVERSAL, TAIWAN_UNIVERSAL, THAILAND_UNIVERSAL, AUSTRALIA_FINSERV,
+                    INDIA_FINSERV, TAIWAN_FINSERV. Meta rejects the ad set without this when the targeting geo
+                    includes the corresponding country.
+                  items: { type: string }
                 endDate: { type: string, format: date-time, description: Required for lifetime budgets }
                 startDate:
                   type: string
@@ -45492,8 +45513,8 @@ paths:
               type: object
               required: [accountId, adAccountId, imageBase64]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 imageBase64: { type: string, description: "Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped)." }
                 filename: { type: string, description: "Optional filename shown in Meta's image library. Defaults to ad_image.jpg." }
       responses:
@@ -45584,8 +45605,8 @@ paths:
               type: object
               required: [accountId, adAccountId]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token." }
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                accountId: { type: string, description: "Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 videoUrl: { type: string, description: "Public https URL of the video; downloaded server-side (SSRF-guarded) before chunked upload. Provide exactly one of videoUrl or videoBase64." }
                 videoBase64: { type: string, description: "Raw base64 video bytes, or a full data URL (the data:video/...;base64, prefix is stripped). Capped by Vercel's body limit (~4.5 MB payload). Provide exactly one of videoUrl or videoBase64." }
                 filename: { type: string, description: "Optional filename shown alongside the upload session. Applied only when uploading via videoBase64." }
@@ -47958,7 +47979,7 @@ paths:
               type: object
               required: [adAccountId, name, pixelId, customEventType, rule]
               properties:
-                adAccountId: { type: string, description: "Meta ad account id (act_<n>)." }
+                adAccountId: { type: string, description: "Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...)." }
                 name: { type: string, maxLength: 255, description: "Also the reuse key, together with pixelId." }
                 pixelId: { type: string, description: "Meta pixel id (event_source_id). From GET /v1/accounts/{accountId}/tracking-tags." }
                 customEventType: { type: string, description: "Meta custom_event_type, e.g. LEAD, PURCHASE, OTHER." }

data/spec/api/ad_campaigns_api_spec.rb

@@ -72,7 +72,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for create_ad_campaign
   # Create a standalone campaign
-  # Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it later via `existingCampaignId` on the create endpoints. A budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the next sync discovery pass.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
+  # Creates a campaign WITHOUT its first ad set / ad, on the platform of the given `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints. Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it for ABO (each ad set carries its own budget), and `specialAdCategories` / `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the campaign GROUP (our campaign level) and rejects a budget, which lives on the campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are created without a status and report `ENABLE`. Created `PAUSED` unless `status: ACTIVE` where the platform supports it.  **Idempotency:** send an `Idempotency-Key` header to make retries safe.
   # @param create_ad_campaign_request 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

data/spec/models/boost_post_request_spec.rb

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

data/spec/models/create_call_ad_request_spec.rb

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

data/spec/models/create_messaging_ad_request_spec.rb

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

data/spec/models/create_standalone_ad_request_spec.rb

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

data/spec/models/ctwa_ad_request_body_spec.rb

@@ -255,4 +255,10 @@ describe Zernio::CtwaAdRequestBody do
     end
   end
 
+  describe 'test attribute "regional_regulated_categories"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.818
+  version: 0.0.820
 platform: ruby
 authors:
 - OpenAPI-Generator
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-01 00:00:00.000000000 Z
+date: 2026-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus