Ad Schedules
Stay organized with collections
Save and categorize content based on your preferences.
Add ad schedules for a campaign
function addAdSchedule(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (campaignIterator.hasNext()) {
const campaign = campaignIterator.next();
// Add a schedule for Monday, 9AM to 5PM, bid modifier = 1.25.
campaign.addAdSchedule('MONDAY', 9, 0, 17, 0, 1.25);
// The bid modifier is optional, e.g.
// campaign.addAdSchedule('MONDAY', 9, 0, 17, 0);
// You can also add an adSchedule as a JSON object, or using
// an existing AdSchedule object.
// Add a schedule for Saturday, 7AM to 11AM, bid modifier = 1.1.
campaign.addAdSchedule({
dayOfWeek: 'SATURDAY',
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
}
}
Get ad schedules for a campaign
function getAdSchedules(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaignIterator.hasNext()) {
throw new Error(`No campaign with name ${campaignName} found.`);
}
const campaign = campaignIterator.next();
const adScheduleIterator = campaign.targeting().adSchedules().get();
console.log(`Campaign "${campaign.name}" has ${
adScheduleIterator.totalNumEntities()} ad schedules`);
return adScheduleIterator;
}
function formatSchedule(schedule) {
function zeroPad(number) { return Utilities.formatString('%02d', number); }
return schedule.getDayOfWeek() + ', ' +
schedule.getStartHour() + ':' + zeroPad(schedule.getStartMinute()) +
' to ' + schedule.getEndHour() + ':' + zeroPad(schedule.getEndMinute());
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-03-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-03-14 UTC."],[[["The provided code snippets demonstrate how to manage ad schedules for Google Ads campaigns using scripts."],["`addAdSchedule` function enables setting specific time slots and bid modifiers for campaigns, enhancing control over ad delivery."],["`getAdSchedules` function retrieves and displays existing ad schedules associated with a given campaign, aiding in schedule monitoring and management."],["Ad schedules can be defined using either direct parameters or a JSON object, offering flexibility in implementation."]]],[]]