Writes (money-moving)
gads_propose_ad_schedule
Manage a campaign's AD SCHEDULE: add schedule windows, remove one, or set a window's bid modifier.
Manage a campaign's AD SCHEDULE: add schedule windows, remove one, or set a window's bid modifier. Review-tier. CAUTION: any schedule restricts serving to its windows — when adding to an unscheduled campaign, cover all 7 days 00–24 and express down-bids via modifiers on the weak windows. Window times are immutable (only the modifier updates); to change a window, remove + add. Modifiers are ignored on Smart Bidding campaigns.
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 | |
op | "add" | "remove" | "set_modifier" | Yes | |
schedules | object[] | No | |
criterionId | string | No | |
bidModifierPercent | number | No | |
reason | string | Yes | |
projectId | string | No | Target account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts. |