late-sdk 0.0.690 → 0.0.691

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4489d0c507f3d38fec9b2a37431974b9f46cdd3d4b1bf90515a70a36cbba8871
-  data.tar.gz: 2d992d7b5b7c13a1756281fd353a065c90a027ac7085830035e8afd7f9ebdb58
+  metadata.gz: b37cfa09d6b3550aac2a1d67795444e2901936164366b5856b511485ecdabd35
+  data.tar.gz: 351eca4be8ad2d79b8696c32562a87644c83b4f543450cf75ed79a4dbf68cff0
 SHA512:
-  metadata.gz: a6615a350d3c26e4ce22ec63eb6d98d2e18b4aaefcde031cb0acc543aed830fcf2e109080cc33bfd1d84a9fd231724d2cb88d731846f4b9c10584fffc76b547f
-  data.tar.gz: a884e66a2bf5f944cecf3f6476f26d8fcfb65f44736b380cb3845c0ad85b25ab42b3a7a298c8a66f5905817ed3b02c71643a1b335f916c531d657079dde137c5
+  metadata.gz: 12771245792d498a567d88509c0eff842a130c6d763f73ca5488681838e1c4a5dfbe98e7d2500e453200d309f3af354c4426de0e36f4135e3a9bb1e61aa7320b
+  data.tar.gz: 6a9e1acbf662ca46711939e3683c2e3c0e094152eb8981bb6cbbcf884ec9f89fadf82fb727b3b670b0f3f6ad09534aefa0ecfe29c545d3efcad728bb4f22f7e1

data/docs/AdCampaignsApi.md

@@ -387,7 +387,7 @@ end
 
 Delete a campaign
 
-Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  Meta-only for now. Other platforms return 501 Not Implemented — fall back to DELETE /v1/ads/{adId} per ad in the meantime.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
+Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
 
 ### Examples
 
@@ -1359,7 +1359,7 @@ end
 
 Update a campaign
 
-Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so this would 404 even though it exists on Meta. Send `accountId` in the body to skip the local lookup and forward the update to Meta. The response then carries `updated: 0`, since there are no local rows to mirror onto. `accountId` is ignored when the campaign does have ads.  - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns   (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint   will return 409 with code BUDGET_LEVEL_MISMATCH. - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and   `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}. - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad   account's currency.  Meta-only for now. Other platforms return 501 Not Implemented. 
+Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name` or `platformSpecificData`. An unsupported field is always an error, never a silent drop.  | Body field | Meta | Google | Others | |---|---|---|---| | `bidStrategy` | Yes | Yes | 501 | | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 | | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 | | `name` | Yes | 501 | 501 | | `platformSpecificData.spendCap` | Yes | 400 | 400 | | `accountId` (empty campaigns) | Yes | - | - |  Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP` to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`), `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since it is shared across campaigns.  `accountId` forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries `updated: 0`. 
 
 ### Examples
 

data/docs/UpdateAdCampaign200Response.md

@@ -4,10 +4,12 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **updated** | **Integer** |  | [optional] |
+| **updated** | **Integer** | Local Ad documents mirrored. 0 on the empty-campaign path. | [optional] |
 | **budget** | [**AdBudget**](AdBudget.md) |  | [optional] |
 | **budget_level** | **String** |  | [optional] |
 | **bid_strategy** | [**BidStrategy**](BidStrategy.md) |  | [optional] |
+| **bid_amount** | **Float** |  | [optional] |
+| **roas_average_floor** | **Float** |  | [optional] |
 | **platform_specific_data** | **Object** |  | [optional] |
 
 ## Example
@@ -20,6 +22,8 @@ instance = Zernio::UpdateAdCampaign200Response.new(
   budget: null,
   budget_level: null,
   bid_strategy: null,
+  bid_amount: null,
+  roas_average_floor: null,
   platform_specific_data: null
 )
 ```

data/docs/UpdateAdCampaignRequest.md

@@ -4,11 +4,13 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from. | [optional] |
-| **platform** | **String** |  |  |
+| **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_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] |
 | **budget** | [**UpdateAdCampaignRequestBudget**](UpdateAdCampaignRequestBudget.md) |  | [optional] |
-| **bid_strategy** | [**BidStrategy**](BidStrategy.md) | Campaign-level default. Ad sets inherit this unless they override. | [optional] |
-| **name** | **String** | Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required. | [optional] |
+| **name** | **String** | **Meta only.** Rename the campaign. | [optional] |
 | **platform_specific_data** | [**UpdateAdCampaignRequestPlatformSpecificData**](UpdateAdCampaignRequestPlatformSpecificData.md) |  | [optional] |
 
 ## Example
@@ -17,10 +19,12 @@
 require 'zernio-sdk'
 
 instance = Zernio::UpdateAdCampaignRequest.new(
-  account_id: null,
   platform: null,
-  budget: null,
+  account_id: null,
   bid_strategy: null,
+  bid_amount: null,
+  roas_average_floor: null,
+  budget: null,
   name: null,
   platform_specific_data: null
 )

data/docs/UpdateAdCampaignRequestPlatformSpecificData.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **spend_cap** | **Float** | Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta). | [optional] |
+| **spend_cap** | **Float** | Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap; 0 is rejected by Meta. | [optional] |
 
 ## Example
 

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

@@ -369,7 +369,7 @@ module Zernio
     end
 
     # Delete a campaign
-    # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  Meta-only for now. Other platforms return 501 Not Implemented — fall back to DELETE /v1/ads/{adId} per ad in the meantime.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
+    # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
     # @param campaign_id [String] Platform campaign ID
     # @param delete_ad_campaign_request [DeleteAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
@@ -380,7 +380,7 @@ module Zernio
     end
 
     # Delete a campaign
-    # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  Meta-only for now. Other platforms return 501 Not Implemented — fall back to DELETE /v1/ads/{adId} per ad in the meantime.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
+    # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
     # @param campaign_id [String] Platform campaign ID
     # @param delete_ad_campaign_request [DeleteAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
@@ -1455,7 +1455,7 @@ module Zernio
     end
 
     # Update a campaign
-    # Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so this would 404 even though it exists on Meta. Send `accountId` in the body to skip the local lookup and forward the update to Meta. The response then carries `updated: 0`, since there are no local rows to mirror onto. `accountId` is ignored when the campaign does have ads.  - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns   (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint   will return 409 with code BUDGET_LEVEL_MISMATCH. - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and   `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}. - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad   account's currency.  Meta-only for now. Other platforms return 501 Not Implemented. 
+    # Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name` or `platformSpecificData`. An unsupported field is always an error, never a silent drop.  | Body field | Meta | Google | Others | |---|---|---|---| | `bidStrategy` | Yes | Yes | 501 | | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 | | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 | | `name` | Yes | 501 | 501 | | `platformSpecificData.spendCap` | Yes | 400 | 400 | | `accountId` (empty campaigns) | Yes | - | - |  Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP` to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`), `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since it is shared across campaigns.  `accountId` forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries `updated: 0`. 
     # @param campaign_id [String] Platform campaign ID
     # @param update_ad_campaign_request [UpdateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters
@@ -1466,7 +1466,7 @@ module Zernio
     end
 
     # Update a campaign
-    # Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so this would 404 even though it exists on Meta. Send `accountId` in the body to skip the local lookup and forward the update to Meta. The response then carries `updated: 0`, since there are no local rows to mirror onto. `accountId` is ignored when the campaign does have ads.  - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns   (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint   will return 409 with code BUDGET_LEVEL_MISMATCH. - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and   `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}. - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad   account's currency.  Meta-only for now. Other platforms return 501 Not Implemented. 
+    # Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name` or `platformSpecificData`. An unsupported field is always an error, never a silent drop.  | Body field | Meta | Google | Others | |---|---|---|---| | `bidStrategy` | Yes | Yes | 501 | | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 | | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 | | `name` | Yes | 501 | 501 | | `platformSpecificData.spendCap` | Yes | 400 | 400 | | `accountId` (empty campaigns) | Yes | - | - |  Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP` to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`), `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since it is shared across campaigns.  `accountId` forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries `updated: 0`. 
     # @param campaign_id [String] Platform campaign ID
     # @param update_ad_campaign_request [UpdateAdCampaignRequest] 
     # @param [Hash] opts the optional parameters

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

@@ -14,7 +14,9 @@ require 'date'
 require 'time'
 
 module Zernio
+  # Echoes back only the fields you sent, plus `updated`.
   class UpdateAdCampaign200Response < ApiModelBase
+    # Local Ad documents mirrored. 0 on the empty-campaign path.
     attr_accessor :updated
 
     attr_accessor :budget
@@ -23,6 +25,10 @@ module Zernio
 
     attr_accessor :bid_strategy
 
+    attr_accessor :bid_amount
+
+    attr_accessor :roas_average_floor
+
     attr_accessor :platform_specific_data
 
     class EnumAttributeValidator
@@ -54,6 +60,8 @@ module Zernio
         :'budget' => :'budget',
         :'budget_level' => :'budgetLevel',
         :'bid_strategy' => :'bidStrategy',
+        :'bid_amount' => :'bidAmount',
+        :'roas_average_floor' => :'roasAverageFloor',
         :'platform_specific_data' => :'platformSpecificData'
       }
     end
@@ -75,6 +83,8 @@ module Zernio
         :'budget' => :'AdBudget',
         :'budget_level' => :'String',
         :'bid_strategy' => :'BidStrategy',
+        :'bid_amount' => :'Float',
+        :'roas_average_floor' => :'Float',
         :'platform_specific_data' => :'Object'
       }
     end
@@ -117,6 +127,14 @@ module Zernio
         self.bid_strategy = attributes[:'bid_strategy']
       end
 
+      if attributes.key?(:'bid_amount')
+        self.bid_amount = attributes[:'bid_amount']
+      end
+
+      if attributes.key?(:'roas_average_floor')
+        self.roas_average_floor = attributes[:'roas_average_floor']
+      end
+
       if attributes.key?(:'platform_specific_data')
         self.platform_specific_data = attributes[:'platform_specific_data']
       end
@@ -158,6 +176,8 @@ module Zernio
           budget == o.budget &&
           budget_level == o.budget_level &&
           bid_strategy == o.bid_strategy &&
+          bid_amount == o.bid_amount &&
+          roas_average_floor == o.roas_average_floor &&
           platform_specific_data == o.platform_specific_data
     end
 
@@ -170,7 +190,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [updated, budget, budget_level, bid_strategy, platform_specific_data].hash
+      [updated, budget, budget_level, bid_strategy, bid_amount, roas_average_floor, platform_specific_data].hash
     end
 
     # Builds the object from hash

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

@@ -15,17 +15,24 @@ require 'time'
 
 module Zernio
   class UpdateAdCampaignRequest < ApiModelBase
-    # Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
-    attr_accessor :account_id
-
+    # Required: platform campaign IDs are not globally unique.
     attr_accessor :platform
 
-    attr_accessor :budget
+    # **Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.
+    attr_accessor :account_id
 
-    # Campaign-level default. Ad sets inherit this unless they override.
+    # **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy.
     attr_accessor :bid_strategy
 
-    # Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
+    # **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.
+    attr_accessor :bid_amount
+
+    # **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.
+    attr_accessor :roas_average_floor
+
+    attr_accessor :budget
+
+    # **Meta only.** Rename the campaign.
     attr_accessor :name
 
     attr_accessor :platform_specific_data
@@ -55,10 +62,12 @@ module Zernio
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'account_id' => :'accountId',
         :'platform' => :'platform',
-        :'budget' => :'budget',
+        :'account_id' => :'accountId',
         :'bid_strategy' => :'bidStrategy',
+        :'bid_amount' => :'bidAmount',
+        :'roas_average_floor' => :'roasAverageFloor',
+        :'budget' => :'budget',
         :'name' => :'name',
         :'platform_specific_data' => :'platformSpecificData'
       }
@@ -77,10 +86,12 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'account_id' => :'String',
         :'platform' => :'String',
-        :'budget' => :'UpdateAdCampaignRequestBudget',
+        :'account_id' => :'String',
         :'bid_strategy' => :'BidStrategy',
+        :'bid_amount' => :'Float',
+        :'roas_average_floor' => :'Float',
+        :'budget' => :'UpdateAdCampaignRequestBudget',
         :'name' => :'String',
         :'platform_specific_data' => :'UpdateAdCampaignRequestPlatformSpecificData'
       }
@@ -108,24 +119,32 @@ module Zernio
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'account_id')
-        self.account_id = attributes[:'account_id']
-      end
-
       if attributes.key?(:'platform')
         self.platform = attributes[:'platform']
       else
         self.platform = nil
       end
 
-      if attributes.key?(:'budget')
-        self.budget = attributes[:'budget']
+      if attributes.key?(:'account_id')
+        self.account_id = attributes[:'account_id']
       end
 
       if attributes.key?(:'bid_strategy')
         self.bid_strategy = attributes[:'bid_strategy']
       end
 
+      if attributes.key?(:'bid_amount')
+        self.bid_amount = attributes[:'bid_amount']
+      end
+
+      if attributes.key?(:'roas_average_floor')
+        self.roas_average_floor = attributes[:'roas_average_floor']
+      end
+
+      if attributes.key?(:'budget')
+        self.budget = attributes[:'budget']
+      end
+
       if attributes.key?(:'name')
         self.name = attributes[:'name']
       end
@@ -156,7 +175,7 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @platform.nil?
-      platform_validator = EnumAttributeValidator.new('String', ["facebook", "instagram"])
+      platform_validator = EnumAttributeValidator.new('String', ["facebook", "instagram", "google"])
       return false unless platform_validator.valid?(@platform)
       return false if !@name.nil? && @name.to_s.length > 255
       true
@@ -165,7 +184,7 @@ module Zernio
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] platform Object to be assigned
     def platform=(platform)
-      validator = EnumAttributeValidator.new('String', ["facebook", "instagram"])
+      validator = EnumAttributeValidator.new('String', ["facebook", "instagram", "google"])
       unless validator.valid?(platform)
         fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
       end
@@ -191,10 +210,12 @@ module Zernio
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          account_id == o.account_id &&
           platform == o.platform &&
-          budget == o.budget &&
+          account_id == o.account_id &&
           bid_strategy == o.bid_strategy &&
+          bid_amount == o.bid_amount &&
+          roas_average_floor == o.roas_average_floor &&
+          budget == o.budget &&
           name == o.name &&
           platform_specific_data == o.platform_specific_data
     end
@@ -208,7 +229,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, platform, budget, bid_strategy, name, platform_specific_data].hash
+      [platform, account_id, bid_strategy, bid_amount, roas_average_floor, budget, name, platform_specific_data].hash
     end
 
     # Builds the object from hash

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

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
+  # **Meta only.** The CBO budget.
   class UpdateAdCampaignRequestBudget < ApiModelBase
     # Budget amount in the ad account's currency
     attr_accessor :amount

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

@@ -14,9 +14,9 @@ require 'date'
 require 'time'
 
 module Zernio
-  # Platform-specific campaign settings. The platform is implied by the `platform` body param (same convention as platformSpecificData on POST /v1/ads/create). Meta (facebook/instagram) only; other platforms return 400. 
+  # **Meta only.** Platform implied by the `platform` body param, same convention as POST /v1/ads/create.
   class UpdateAdCampaignRequestPlatformSpecificData < ApiModelBase
-    # Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta).
+    # Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap; 0 is rejected by Meta.
     attr_accessor :spend_cap
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -36573,7 +36573,7 @@ paths:
       x-resource-group: "ads"
       operationId: updateAdCampaignStatus
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta", "google", "tiktok", "linkedin", "pinterest", "x"]
+      x-platforms: ["meta", "google", "tiktok", "linkedin", "pinterest", "x", "openai"]
       summary: Pause or resume a campaign
       description: |
         Updates the status of all ads in a campaign. Makes one platform API call (not per-ad) since status cascades through the campaign hierarchy.
@@ -36615,26 +36615,31 @@ paths:
       x-resource-group: "ads"
       operationId: updateAdCampaign
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta", "google", "tiktok", "linkedin", "pinterest", "x"]
+      x-platforms: ["meta", "google"]
       summary: Update a campaign
       description: |
-        Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.
+        Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name`
+        or `platformSpecificData`. An unsupported field is always an error, never a
+        silent drop.
 
-        **Empty campaigns.** A campaign with zero ads has no local Ad documents to
-        resolve, so this would 404 even though it exists on Meta. Send `accountId`
-        in the body to skip the local lookup and forward the update to Meta. The
-        response then carries `updated: 0`, since there are no local rows to mirror
-        onto. `accountId` is ignored when the campaign does have ads.
+        | Body field | Meta | Google | Others |
+        |---|---|---|---|
+        | `bidStrategy` | Yes | Yes | 501 |
+        | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 |
+        | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 |
+        | `name` | Yes | 501 | 501 |
+        | `platformSpecificData.spendCap` | Yes | 400 | 400 |
+        | `accountId` (empty campaigns) | Yes | - | - |
 
-        - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns
-          (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint
-          will return 409 with code BUDGET_LEVEL_MISMATCH.
-        - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and
-          `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}.
-        - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad
-          account's currency.
+        Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP`
+        to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max
+        CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`),
+        `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on
+        a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since
+        it is shared across campaigns.
 
-        Meta-only for now. Other platforms return 501 Not Implemented.
+        `accountId` forwards the update straight to Meta for a campaign with zero ads,
+        which would otherwise 404; the response then carries `updated: 0`.
       security:
         - bearerAuth: []
       parameters:
@@ -36647,26 +36652,26 @@ paths:
               type: object
               required: [platform]
               properties:
-                accountId: { type: string, description: "Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from." }
-                platform: { type: string, enum: [facebook, instagram] }
+                platform: { type: string, enum: [facebook, instagram, google], description: "Required: platform campaign IDs are not globally unique." }
+                accountId: { type: string, description: "**Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise." }
+                bidStrategy:
+                  allOf: [{ $ref: '#/components/schemas/BidStrategy' }]
+                  description: "**Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy."
+                bidAmount: { type: number, description: "**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." }
+                roasAverageFloor: { type: number, description: "**Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS." }
                 budget:
                   type: object
+                  description: "**Meta only.** The CBO budget."
                   required: [amount, type]
                   properties:
                     amount: { type: number, description: Budget amount in the ad account's currency }
                     type: { type: string, enum: [daily, lifetime] }
-                bidStrategy:
-                  allOf: [{ $ref: '#/components/schemas/BidStrategy' }]
-                  description: "Campaign-level default. Ad sets inherit this unless they override."
-                name: { type: string, maxLength: 255, description: "Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required." }
+                name: { type: string, maxLength: 255, description: "**Meta only.** Rename the campaign." }
                 platformSpecificData:
                   type: object
-                  description: |
-                    Platform-specific campaign settings. The platform is implied by the `platform`
-                    body param (same convention as platformSpecificData on POST /v1/ads/create).
-                    Meta (facebook/instagram) only; other platforms return 400.
+                  description: "**Meta only.** Platform implied by the `platform` body param, same convention as POST /v1/ads/create."
                   properties:
-                    spendCap: { type: [number, "null"], description: "Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta)." }
+                    spendCap: { type: [number, "null"], description: "Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap; 0 is rejected by Meta." }
       responses:
         '200':
           description: Campaign updated
@@ -36674,13 +36679,16 @@ paths:
             application/json:
               schema:
                 type: object
+                description: Echoes back only the fields you sent, plus `updated`.
                 properties:
-                  updated: { type: integer }
+                  updated: { type: integer, description: "Local Ad documents mirrored. 0 on the empty-campaign path." }
                   budget: { $ref: '#/components/schemas/AdBudget' }
                   budgetLevel: { type: string, enum: [campaign] }
                   bidStrategy: { $ref: '#/components/schemas/BidStrategy' }
+                  bidAmount: { type: number }
+                  roasAverageFloor: { type: number }
                   platformSpecificData: { type: object }
-        '400': { description: Invalid input }
+        '400': { description: "Invalid input, or a field the resolved platform does not support at the campaign level (see the support table)" }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Campaign not found }
         '409': { description: "Campaign is ABO — route to /v1/ads/ad-sets/{adSetId} instead" }
@@ -36690,16 +36698,13 @@ paths:
       x-resource-group: "ads"
       operationId: deleteAdCampaign
       tags: ["Ad Campaigns"]
-      x-platforms: ["meta", "google", "tiktok", "linkedin", "pinterest", "x"]
+      x-platforms: ["meta", "tiktok"]
       summary: Delete a campaign
       description: |
         Deletes the whole campaign on the platform, cascading to its ad sets
         and ads. Locally, all Ad documents for this campaign are marked
         `status: cancelled`.
 
-        Meta-only for now. Other platforms return 501 Not Implemented — fall
-        back to DELETE /v1/ads/{adId} per ad in the meantime.
-
         **Empty campaigns.** A campaign with zero ads has no local Ad documents
         to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would
         404. That state is produced by the two-step create flow (campaign, then

data/spec/api/ad_campaigns_api_spec.rb

@@ -96,7 +96,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for delete_ad_campaign
   # Delete a campaign
-  # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  Meta-only for now. Other platforms return 501 Not Implemented — fall back to DELETE /v1/ads/{adId} per ad in the meantime.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
+  # Deletes the whole campaign on the platform, cascading to its ad sets and ads. Locally, all Ad documents for this campaign are marked `status: cancelled`.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would 404. That state is produced by the two-step create flow (campaign, then ads via `existingCampaignId`) whenever Meta rejects the ad step. To delete such a shell, send `accountId` in the body: we skip the local lookup entirely and forward the delete to Meta. `accountId` is ignored when the campaign does have ads. 
   # @param campaign_id Platform campaign ID
   # @param delete_ad_campaign_request 
   # @param [Hash] opts the optional parameters
@@ -303,7 +303,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for update_ad_campaign
   # Update a campaign
-  # Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.  **Empty campaigns.** A campaign with zero ads has no local Ad documents to resolve, so this would 404 even though it exists on Meta. Send `accountId` in the body to skip the local lookup and forward the update to Meta. The response then carries `updated: 0`, since there are no local rows to mirror onto. `accountId` is ignored when the campaign does have ads.  - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns   (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint   will return 409 with code BUDGET_LEVEL_MISMATCH. - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and   `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}. - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad   account's currency.  Meta-only for now. Other platforms return 501 Not Implemented. 
+  # Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name` or `platformSpecificData`. An unsupported field is always an error, never a silent drop.  | Body field | Meta | Google | Others | |---|---|---|---| | `bidStrategy` | Yes | Yes | 501 | | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 | | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 | | `name` | Yes | 501 | 501 | | `platformSpecificData.spendCap` | Yes | 400 | 400 | | `accountId` (empty campaigns) | Yes | - | - |  Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP` to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`), `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since it is shared across campaigns.  `accountId` forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries `updated: 0`. 
   # @param campaign_id Platform campaign ID
   # @param update_ad_campaign_request 
   # @param [Hash] opts the optional parameters

data/spec/models/update_ad_campaign200_response_spec.rb

@@ -55,6 +55,18 @@ describe Zernio::UpdateAdCampaign200Response do
     end
   end
 
+  describe 'test attribute "bid_amount"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "roas_average_floor"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "platform_specific_data"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/update_ad_campaign_request_spec.rb

@@ -27,29 +27,41 @@ describe Zernio::UpdateAdCampaignRequest do
     end
   end
 
+  describe 'test attribute "platform"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["facebook", "instagram", "google"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.platform = value }.not_to raise_error
+      # end
+    end
+  end
+
   describe 'test attribute "account_id"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "platform"' do
+  describe 'test attribute "bid_strategy"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["facebook", "instagram"])
-      # validator.allowable_values.each do |value|
-      #   expect { instance.platform = value }.not_to raise_error
-      # end
     end
   end
 
-  describe 'test attribute "budget"' do
+  describe 'test attribute "bid_amount"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "bid_strategy"' do
+  describe 'test attribute "roas_average_floor"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "budget"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.690
+  version: 0.0.691
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -5018,7 +5018,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.690.gem
+- zernio-sdk-0.0.691.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: