Ad Campaigns

Read a campaign's ad schedule (dayparting)

Changed on Nov 10, 2026

Shows the days and hours a Google campaign runs and its bid adjustments, optionally with performance by day and hour.

The windows a Google campaign serves in, with the bid modifier on each, plus the criterion ids Google minted for them.

An EMPTY schedule is meaningful and is not a failed lookup: Google has no "all day" criterion, so a campaign with no ad schedule serves around the clock. servesAroundTheClock states that explicitly.

Set includePerformance=true to also get delivery split by day of week and by hour, which is the evidence for deciding what the schedule should be. It is one extra Google call segmented by both dimensions at once, so the two views always agree.

Google Ads only. The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

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

Request

Base URL
https://zernio.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/zernio/apis/zernio-api/docs/v1/ads/campaigns/:campaignId/ad-schedule/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

campaignIdstring required

Numeric Google platform campaign id.

Query parameters

platform'google'

Disambiguates the campaign id when the connection spans platforms.

includePerformanceboolean

Also return delivery by day of week and by hour. Costs one extra Google call.

windowDaysinteger

Trailing window for the performance split. Ignored when fromDate and toDate are both given.

fromDatestring date

Start of an explicit performance range (YYYY-MM-DD). Use together with toDate.

toDatestring date

End of an explicit performance range (YYYY-MM-DD). Must be on or after fromDate.

Response

The campaign's ad schedule

campaignIdstring

servesAroundTheClockboolean

True when the campaign carries no ad schedule at all, so it can serve at any time.

cachedAtstring date-time nullable

staleboolean

True when a quota-exhausted read served the last-good copy.

Changes

Nov 10, 2026d568bb00ed73 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 6, 2026f8c8f34fb41a Revision changes
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status

Operation history (8 revisions)