ZEzernio
Ad Campaigns

Replace a campaign's ad schedule (dayparting)

Changed on

Replaces the days and hours a Google campaign runs, or clears them so it serves around the clock.

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.

Rules

Google rules are 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
  • 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.

How it is applied

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

Request

Path parameters

campaignIdstring required

Numeric Google platform campaign id.

Request body

Response

The schedule as Google stored it

campaignIdstring
servesAroundTheClockboolean

Changes

  • d568bb00ed73Revision 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

  • f8c8f34fb41aRevision 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