Writes (money-moving)
gads_propose_ad_schedule_bid_modifier
Propose a bid adjustment on one of a campaign's ad schedule windows (-30 = bid 30% less in that window; 20 = bid 20% more).
Propose a bid adjustment on one of a campaign's ad schedule windows (-30 = bid 30% less in that window; 20 = bid 20% more). It always waits for a person to approve it; nothing changes in Google Ads before then, and an applied change can be reverted. Google ignores schedule bid adjustments on Smart Bidding campaigns. A GAQL query on campaign_criterion (type AD_SCHEDULE) lists the criterion ids.
Type: money-moving write. Every write is dry-run validated, then classified by the safe-apply policy — auto-applied when bounded and low-risk, otherwise queued for approval.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaignId | string | Yes | The campaign the window belongs to. |
criterionId | string | Yes | The ad schedule criterion id to adjust. |
bidModifierPercent | number | Yes | The new adjustment: -30 = bid 30% less; 20 = bid 20% more. |
reason | string | Yes | Why this change, shown to the approver. |
projectId | string | No | Target account (project id). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts. |