Writes (money-moving)

gads_propose_add_ad_schedule

Propose adding ad schedule windows to a campaign: the days and hours its ads may serve.

Propose adding ad schedule windows to a campaign: the days and hours its ads may serve. A schedule limits serving to its windows, so a campaign's first schedule must cover all 7 days, 00 to 24 (a partial first schedule is refused); bid less on weak hours with a window's bid adjustment instead. It always waits for a person to approve it; nothing changes in Google Ads before then, and an applied change can be reverted.

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

ParameterTypeRequiredDescription
campaignIdstringYesThe campaign to schedule.
schedulesobject[]YesThe windows to add.
reasonstringYesWhy this change, shown to the approver.
projectIdstringNoTarget 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.

On this page