late-sdk 0.0.690 → 0.0.692

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

@@ -0,0 +1,165 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class MoveWhatsAppNumberToProfileRequest < ApiModelBase
+    # Destination profile id. Must belong to the same team.
+    attr_accessor :profile_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'profile_id' => :'profileId'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'profile_id' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::MoveWhatsAppNumberToProfileRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::MoveWhatsAppNumberToProfileRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'profile_id')
+        self.profile_id = attributes[:'profile_id']
+      else
+        self.profile_id = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @profile_id.nil?
+        invalid_properties.push('invalid value for "profile_id", profile_id cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @profile_id.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] profile_id Value to be assigned
+    def profile_id=(profile_id)
+      if profile_id.nil?
+        fail ArgumentError, 'profile_id cannot be nil'
+      end
+
+      @profile_id = profile_id
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          profile_id == o.profile_id
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [profile_id].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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.692'
 end

data/lib/zernio-sdk.rb

@@ -993,6 +993,8 @@ require 'zernio-sdk/models/money'
 require 'zernio-sdk/models/money_amount'
 require 'zernio-sdk/models/move_account_to_profile200_response'
 require 'zernio-sdk/models/move_account_to_profile_request'
+require 'zernio-sdk/models/move_whats_app_number_to_profile200_response'
+require 'zernio-sdk/models/move_whats_app_number_to_profile_request'
 require 'zernio-sdk/models/on_verification_approved_request'
 require 'zernio-sdk/models/on_verification_approved_request_verification'
 require 'zernio-sdk/models/on_verification_failed_request'

data/openapi.yaml

@@ -32260,6 +32260,64 @@ paths:
         '400': { description: Country does not require KYC (not a regulated country). }
         '401': { $ref: '#/components/responses/Unauthorized' }
 
+  /v1/whatsapp/phone-numbers/{id}/profile:
+    patch:
+      x-resource-group: "telephony"
+      operationId: moveWhatsAppNumberToProfile
+      tags: [WhatsApp Phone Numbers]
+      summary: Move a number to another profile
+      description: |
+        Move a provisioned number to a different profile.
+
+        A number is not a single record. Alongside the number itself there are
+        hidden telephony owner accounts (platform `phone`, plus `sms` when SMS is
+        enabled) and, once WhatsApp is connected, the `whatsapp` account. They all
+        carry a profileId and this endpoint moves them together.
+
+        Use this instead of `PATCH /v1/accounts/{accountId}`: that one moves the
+        social account only and leaves the number itself pinned to its original
+        profile, which splits the number across two profiles. Connecting a
+        provisioned number always places it on the profile the NUMBER is on, so a
+        `profileId` passed to `GET /v1/connect/whatsapp` cannot re-home it and a
+        later reconnect pulls the account back. This endpoint is how you re-home it.
+
+        `id` is the number record id from `GET /v1/phone-numbers`, not an account id.
+
+        A profile holds at most one account per platform, so the destination must be
+        free of every platform this number occupies.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: string }, description: WhatsAppPhoneNumber id. }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [profileId]
+              properties:
+                profileId: { type: string, description: Destination profile id. Must belong to the same team. }
+      responses:
+        '200':
+          description: Number moved, or already on that profile.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message: { type: string }
+                  profileId: { type: string, description: The profile the number is now on. }
+                  movedPlatforms:
+                    type: array
+                    items: { type: string }
+                    description: 'Platforms whose accounts travelled with the number (phone, sms, whatsapp). Absent when the number was already on the destination profile.'
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403': { description: 'No access to the source or destination profile, or the Inbox add-on is not active.' }
+        '404': { description: 'Number not found, or the destination profile does not exist.' }
+        '409': { description: 'The destination profile already holds an account on one of the platforms this number occupies.' }
+
   /v1/whatsapp/phone-numbers/{id}/remediate:
     get:
       x-resource-group: "telephony"
@@ -36573,7 +36631,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 +36673,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 +36710,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 +36737,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 +36756,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