late-sdk 0.0.859 → 0.0.860

data/docs/CreateBidStrategyRequest.md

@@ -0,0 +1,28 @@
+# Zernio::CreateBidStrategyRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **name** | **String** |  |  |
+| **type** | **String** |  |  |
+| **target_cpa** | **Float** | Required when type is TARGET_CPA, in the account's currency units. | [optional] |
+| **target_roas** | **Float** | Required when type is TARGET_ROAS; a multiplier (2.0 = 2.0x). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateBidStrategyRequest.new(
+  account_id: null,
+  customer_id: null,
+  name: null,
+  type: null,
+  target_cpa: null,
+  target_roas: null
+)
+```
+

data/docs/CreateStandaloneAdRequest.md

@@ -89,9 +89,10 @@
 | **advantage_audience** | **Integer** | Meta only. Controls the Advantage audience feature (targeting_automation). 0 = disabled (default), 1 = enabled. Meta Marketing API requires this field on all ad set creation requests. | [optional] |
 | **attribution_spec** | [**Array<CreateStandaloneAdRequestAttributionSpecInner>**](CreateStandaloneAdRequestAttributionSpecInner.md) | Meta only. Conversion attribution window for the ad set — maps 1:1 to Meta's ad-set `attribution_spec`. Only honored for conversion goals (`conversions`, `lead_generation`, `app_promotion`); ignored for awareness/traffic/engagement. Omit to use Meta's default (`7-day click` + `1-day view`). Meta enforces the valid combinations: `VIEW_THROUGH` only allows `windowDays: 1` (7d/28d view windows were removed Jan 2026); `ENGAGED_VIDEO_VIEW` only `1` and only alongside `VIEW_THROUGH: 1`; `CLICK_THROUGH: 28` only on certain objectives. Invalid combos surface as a Meta 400. Example: `[{ \"eventType\": \"CLICK_THROUGH\", \"windowDays\": 7 }, { \"eventType\": \"VIEW_THROUGH\", \"windowDays\": 1 }]`  | [optional] |
 | **gender** | **String** | Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X. | [optional][default to 'all'] |
-| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.  Meta bid strategy applied to the ad set.  OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.  | [optional] |
+| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.  Meta bid strategy applied to the ad set.  OpenAI Ads: required on every ad group via this flat field, the only channel it supports (`platformSpecificData` is Meta/LinkedIn-only and returns 400 for OpenAI). No auto-bid option exists; send `LOWEST_COST_WITH_BID_CAP` or `COST_CAP` together with `bidAmount`, omitting it returns 400.  Google (not deprecated there, this shared flat field is Google's only shape): applied to the campaign this call creates. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. Omitted, the campaign falls back to a goal-based default.  | [optional] |
 | **bid_amount** | **Float** | Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.  Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. Meta only: sending `bidAmount` WITHOUT `bidStrategy` requires `existingCampaignId` (400 otherwise), and sets the new ad set's cap under the joined campaign's COST_CAP / LOWEST_COST_WITH_BID_CAP parent. The strategy itself is inherited from the campaign. Restating bidStrategy here is accepted but has no effect on the ad set.  Rejected with 400 in `adSetId` attach mode: that shape inherits its cap from the platform. Use `PUT /v1/ads/ad-sets/{adSetId}` there instead.  | [optional] |
 | **roas_average_floor** | **Float** | Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.  Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sending it without `bidStrategy` is a 400. Sent to Meta as `bid_constraints.roas_average_floor` × 10000. Known gap: a CBO campaign's ROAS floor lives on the campaign only (set via `POST /v1/ads/campaigns`); there is no supported way to set it while joining a CBO campaign here.  | [optional] |
+| **portfolio_bid_strategy_id** | **String** | Google only. Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) to the new campaign instead of a standard one. Exclusive with bidStrategy. | [optional] |
 | **value_rule_set_id** | **String** | Meta only (facebook, instagram; other platforms return 400). Value rule set to attach to the new ad set, from `/v1/ads/value-rule-sets`. Attachment is driven by this id, so `valueRulesApplied` is optional alongside it.  Rejected with 400 in `adSetId` attach mode: that shape inherits the existing ad set's attachment, so the field would be silently ignored. Use `PUT /v1/ads/ad-sets/{adSetId}` there instead.  Ignored (stripped before the ad-set create) when `buyingType` is `RESERVED`: value rules only apply to auction ad sets on `LOWEST_COST_WITHOUT_CAP` or `COST_CAP`, and a Reach & Frequency reservation has no auction bid strategy.  Read back with `GET /v1/ads/ad-sets/{adSetId}?fields=value_rule_set_id`; the attachment is not mirrored onto Zernio's ad documents.  | [optional] |
 | **value_rules_applied** | **Boolean** | Meta only (facebook, instagram; other platforms return 400). Optional when attaching, and requires `valueRuleSetId`. `false` is REJECTED here with 400: a newly created ad set has nothing to detach, so detaching lives on `PUT /v1/ads/ad-sets/{adSetId}`.  | [optional] |
 | **platform_specific_data** | [**CreateStandaloneAdRequestPlatformSpecificData**](CreateStandaloneAdRequestPlatformSpecificData.md) |  | [optional] |
@@ -196,6 +197,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,
+  portfolio_bid_strategy_id: null,
   value_rule_set_id: null,
   value_rules_applied: null,
   platform_specific_data: null,

data/docs/GetCampaignBidding200Response.md

@@ -0,0 +1,26 @@
+# Zernio::GetCampaignBidding200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **channel** | **String** | campaign.advertising_channel_type. COST_CAP's underlying Google field differs by channel; see bidStrategy on PUT. | [optional] |
+| **bidding_strategy_type** | **String** | Google's raw enum: MAXIMIZE_CONVERSIONS, TARGET_CPA, MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS, TARGET_SPEND, MANUAL_CPC, TARGET_IMPRESSION_SHARE, or another Google adds later. | [optional] |
+| **bid_spec** | [**CampaignBiddingBidSpec**](CampaignBiddingBidSpec.md) |  | [optional] |
+| **portfolio** | [**CampaignBiddingPortfolio**](CampaignBiddingPortfolio.md) |  | [optional] |
+| **campaign_id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetCampaignBidding200Response.new(
+  channel: null,
+  bidding_strategy_type: null,
+  bid_spec: null,
+  portfolio: null,
+  campaign_id: null
+)
+```
+

data/docs/ListBidStrategies200Response.md

@@ -0,0 +1,22 @@
+# Zernio::ListBidStrategies200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **customer_id** | **String** |  | [optional] |
+| **currency** | **String** | Account currency code; money fields are in this currency's units. | [optional] |
+| **strategies** | [**Array<PortfolioBidStrategy>**](PortfolioBidStrategy.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ListBidStrategies200Response.new(
+  customer_id: null,
+  currency: null,
+  strategies: null
+)
+```
+

data/docs/PortfolioBidStrategy.md

@@ -0,0 +1,42 @@
+# Zernio::PortfolioBidStrategy
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Numeric bid strategy id; pass as portfolioBidStrategyId or in the {strategyId} path. | [optional] |
+| **name** | **String** |  | [optional] |
+| **type** | **String** |  | [optional] |
+| **status** | **String** | ENABLED or REMOVED. | [optional] |
+| **campaign_count** | **Integer** | Number of campaigns currently attached. | [optional] |
+| **clicks** | **Integer** |  | [optional] |
+| **cost** | **Float** | Cost in the account's currency units (converted from micros). | [optional] |
+| **cost_per_conversion** | **Float** | Cost per conversion in the account's currency units. | [optional] |
+| **impressions** | **Integer** |  | [optional] |
+| **average_cpc** | **Float** | Average CPC in the account's currency units. | [optional] |
+| **conversions** | **Float** |  | [optional] |
+| **target_cpa** | **Float** | Current target, in the account's currency units. Null for a ROAS-family type (TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE), or a Maximize type with no target set. Pre-fills the edit form's target field. | [optional] |
+| **target_roas** | **Float** | Current target as a decimal multiplier (2.0 = 2.0x). Null for a CPA-family type (TARGET_CPA, MAXIMIZE_CONVERSIONS), or a Maximize type with no target set. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::PortfolioBidStrategy.new(
+  id: null,
+  name: null,
+  type: null,
+  status: null,
+  campaign_count: null,
+  clicks: null,
+  cost: null,
+  cost_per_conversion: null,
+  impressions: null,
+  average_cpc: null,
+  conversions: null,
+  target_cpa: null,
+  target_roas: null
+)
+```
+

data/docs/UpdateAdCampaign200Response.md

@@ -10,6 +10,7 @@
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
 | **bid_amount** | **Float** |  | [optional] |
 | **roas_average_floor** | **Float** |  | [optional] |
+| **portfolio_bid_strategy_id** | **String** | Google only. Echoed back, but NOT mirrored onto local Ad documents (no column for it yet). | [optional] |
 | **platform_specific_data** | **Object** |  | [optional] |
 
 ## Example
@@ -24,6 +25,7 @@ instance = Zernio::UpdateAdCampaign200Response.new(
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,
+  portfolio_bid_strategy_id: null,
   platform_specific_data: null
 )
 ```

data/docs/UpdateAdCampaignRequest.md

@@ -6,9 +6,10 @@
 | ---- | ---- | ----------- | ----- |
 | **platform** | **String** | Required: platform campaign IDs are not globally unique. |  |
 | **account_id** | **String** | **Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise. | [optional] |
-| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy. | [optional] |
+| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy. On Google: LOWEST_COST_WITHOUT_CAP = Maximize Conversions, COST_CAP + bidAmount = Target CPA, LOWEST_COST_WITH_MIN_ROAS + roasAverageFloor = Target ROAS, LOWEST_COST_WITH_BID_CAP + bidAmount = Maximize Clicks with a CPC ceiling; portfolioBidStrategyId attaches a portfolio strategy instead. | [optional] |
 | **bid_amount** | **Float** | **Google only.** Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both. | [optional] |
 | **roas_average_floor** | **Float** | **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS. | [optional] |
+| **portfolio_bid_strategy_id** | **String** | **Google only.** Attach an existing portfolio bid strategy (numeric id from GET /v1/ads/bid-strategies) instead of setting bidStrategy. Exclusive with bidStrategy. | [optional] |
 | **budget** | [**UpdateAdCampaignRequestBudget**](UpdateAdCampaignRequestBudget.md) |  | [optional] |
 | **name** | **String** | **Meta only.** Rename the campaign. | [optional] |
 | **platform_specific_data** | [**UpdateAdCampaignRequestPlatformSpecificData**](UpdateAdCampaignRequestPlatformSpecificData.md) |  | [optional] |
@@ -24,6 +25,7 @@ instance = Zernio::UpdateAdCampaignRequest.new(
   bid_strategy: null,
   bid_amount: null,
   roas_average_floor: null,
+  portfolio_bid_strategy_id: null,
   budget: null,
   name: null,
   platform_specific_data: null

data/docs/UpdateAdRequestTargeting.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **keywords** | [**Array<UpdateAdRequestTargetingKeywordsInner>**](UpdateAdRequestTargetingKeywordsInner.md) | Google only. The FULL new set of positive keywords for the ad group; live keywords not listed are removed. Entries are strings (BROAD) or { text, matchType } with matchType exact | phrase | broad. Mirrored to GET /v1/ads/keywords immediately. | [optional] |
 | **negative_keywords** | [**Array<UpdateAdRequestTargetingKeywordsInner>**](UpdateAdRequestTargetingKeywordsInner.md) | Google only. Same declarative contract as keywords, for the ad group's negative keywords. | [optional] |
+| **devices** | [**Array<UpdateAdRequestTargetingDevicesInner>**](UpdateAdRequestTargetingDevicesInner.md) | Google only. The FULL new set of device criteria for the campaign; devices not listed are excluded. Entries are a device name alone (included, no bid adjustment) or { device, bidModifier }. | [optional] |
 | **age_min** | **Integer** |  | [optional] |
 | **age_max** | **Integer** |  | [optional] |
 | **countries** | **Array<String>** |  | [optional] |
@@ -20,6 +21,7 @@ require 'zernio-sdk'
 instance = Zernio::UpdateAdRequestTargeting.new(
   keywords: null,
   negative_keywords: null,
+  devices: null,
   age_min: null,
   age_max: null,
   countries: null,

data/docs/UpdateAdRequestTargetingDevicesInner.md

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

data/docs/UpdateAdRequestTargetingDevicesInnerOneOf.md

@@ -0,0 +1,20 @@
+# Zernio::UpdateAdRequestTargetingDevicesInnerOneOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **device** | **String** |  |  |
+| **bid_modifier** | **Float** | Google device bid modifier, 0.1 to 10 (minus 90% to plus 900%). Omit a device to exclude it. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateAdRequestTargetingDevicesInnerOneOf.new(
+  device: null,
+  bid_modifier: null
+)
+```
+

data/docs/UpdateBidStrategy200Response.md

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

data/docs/UpdateBidStrategy200ResponseStrategy.md

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

data/docs/UpdateBidStrategyRequest.md

@@ -0,0 +1,28 @@
+# Zernio::UpdateBidStrategyRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Google ads SocialAccount id. |  |
+| **customer_id** | **String** | Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer. | [optional] |
+| **name** | **String** |  | [optional] |
+| **type** | **String** |  | [optional] |
+| **target_cpa** | **Float** |  | [optional] |
+| **target_roas** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateBidStrategyRequest.new(
+  account_id: null,
+  customer_id: null,
+  name: null,
+  type: null,
+  target_cpa: null,
+  target_roas: null
+)
+```
+