Ad Campaigns

Replace a campaign's ad schedule (dayparting)

Replaces the campaign's whole ad schedule with the windows you send. This is a REPLACE, not a merge: windows you leave out stop serving.

Send schedule: [] to clear dayparting, which returns the campaign to serving around the clock.

Google rules enforced here, so you get a named field instead of a criterion error: at most 6 windows per day, a window must end after it starts, windows on the same day may not overlap, endHour 24 is midnight and cannot carry minutes, and minutes are quarter-hours only (0, 15, 30, 45). bidModifier is 0.1-10.0; Google's 0 means "off" for devices only, so a window is switched off by leaving it out.

Windows are half-open (Google is exclusive of the end minute), so 09:00-12:00 and 12:00-17:00 on the same day are adjacent and both valid.

Google cannot edit an ad schedule in place (every AdScheduleInfo field is prohibited on update), so this removes the live criteria and creates the new ones in a single atomic mutate. The response is read back from Google and carries the new criterion ids.

put/v1/ads/campaigns/{campaignId}/ad-schedule

Path parameters

campaignIdstring required

Numeric Google platform campaign id.

Request body

Response

The schedule as Google stored it

campaignIdstring
servesAroundTheClockboolean

Changes