update_adset

Update an ad set with new settings including frequency caps and budgets.

Args:
    adset_id: Meta Ads ad set ID
    name: New ad set name
    frequency_control_specs: Frequency control specs
                             (e.g. [{"event": "IMPRESSIONS", "interval_days": 7, "max_frequency": 3}])
    bid_strategy: Bid strategy. Valid values:
                 - 'LOWEST_COST_WITHOUT_CAP' (recommended) - no bid_amount required
                 - 'LOWEST_COST_WITH_BID_CAP' - REQUIRES bid_amount
                 - 'COST_CAP' - REQUIRES bid_amount
                 - 'LOWEST_COST_WITH_MIN_ROAS' - REQUIRES bid_constraints with roas_average_floor
                 Note: 'LOWEST_COST' is NOT valid - use 'LOWEST_COST_WITHOUT_CAP'.
    bid_amount: Bid amount in cents. Required for LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
               NOT USED by LOWEST_COST_WITH_MIN_ROAS (uses bid_constraints instead).
    bid_constraints: Bid constraints dict. Required for LOWEST_COST_WITH_MIN_ROAS.
                    Use {"roas_average_floor": <value>} where value = target ROAS * 10000.
                    Example: 2.0x ROAS -> {"roas_average_floor": 20000}
    bid_adjustments: Bid multipliers per targeting dimension. Pass-through to Meta.
                    Shape: {"user_groups": {"<dim>": {"<value>": <float>, "default": <float>}}}
                    See create_adset for full docs and dim list.
                    NOTE: Writing requires a Meta app capability that must be allowlisted.
    status: Update ad set status (ACTIVE, PAUSED, etc.)
    targeting: Complete targeting specifications (replaces existing targeting)
    optimization_goal: Conversion optimization goal (e.g., 'LINK_CLICKS', 'CONVERSIONS', 'VALUE')
    daily_budget: Daily budget in account currency (in cents)
    lifetime_budget: Lifetime budget in account currency (in cents)
    is_dynamic_creative: Enable/disable Dynamic Creative for this ad set.
                        WARNING: This field is immutable after ad set creation. Meta's API will
                        return success but silently ignore the change. To change this, create a new ad set.
    start_time: Start time in ISO 8601 format (e.g., '2023-12-01T12:00:00-0800').
               Use with status=ACTIVE to schedule the ad set for future delivery (effective_status will be SCHEDULED until start_time).
    end_time: End time in ISO 8601 format. Required when lifetime_budget is specified.
    dsa_beneficiary: DSA beneficiary for European compliance (person/org that benefits from ads).
                    Required for EU-targeted ad sets along with dsa_payor.
    dsa_payor: DSA payor for European compliance (person/org paying for the ads).
               Required for EU-targeted ad sets along with dsa_beneficiary.
    multi_advertiser_ads: Set to 0 to opt out of Multi-Advertiser Ads, 1 to opt in.
                         This is a TOP-LEVEL ad set parameter — do NOT put it inside the targeting object.
    regional_regulated_categories: List of regional regulated categories for the ad set.
                                   Required for ads targeting regulated regions (Taiwan, Australia, etc.).
                                   Valid values: TAIWAN_FINSERV, TAIWAN_UNIVERSAL, AUSTRALIA_FINSERV,
                                   INDIA_FINSERV, SINGAPORE_UNIVERSAL, THAILAND_UNIVERSAL.
                                   Set to null/empty to remove existing categories.
    regional_regulation_identities: Dict of verified identity IDs for regional transparency compliance.
                                    Required when regional_regulated_categories is set.
                                    Set individual keys to null to remove them.
    attribution_spec: Attribution window specification for the ad set.
                     WARNING: Meta no longer supports updating attribution_spec after ad set creation
                     (error 1504040). To change attribution windows, create a new ad set instead.
                     This parameter is kept for compatibility but will be rejected by Meta's API.
                     Valid event_type values: CLICK_THROUGH, VIEW_THROUGH.
                     Valid window_days values: 1, 7, 28 (depends on event_type and optimization_goal).
    access_token: Meta API access token (optional - will use cached token if not provided)