Budget Orders
Stay organized with collections
Save and categorize content based on your preferences.
Retrieve base spending limit of budget order
function getBaseSpendingLimit() {
const budgetOrderIterator = AdsApp.budgetOrders().get();
for (const budgetOrder of budgetOrderIterator) {
let limitText = "";
if (budgetOrder.getSpendingLimit() == null) {
limitText = "unlimited";
} else if (budgetOrder.getTotalAdjustments() == null) {
limitText = budgetOrder.getSpendingLimit();
} else {
limitText = budgetOrder.getSpendingLimit() -
budgetOrder.getTotalAdjustments();
}
console.log("Budget Order [" + budgetOrder.getName() +
"] base spending limit: " + limitText);
}
}
Retrieve the active budget order
function getActiveBudgetOrder() {
// There will only be one active budget order at any given time.
const budgetOrderIterator = AdsApp.budgetOrders()
.withCondition('account_budget.status = "ACTIVE"')
.get();
for (const budgetOrder of budgetOrderIterator) {
const budgetOrder = budgetOrderIterator.next();
console.log(`Budget Order [${budgetOrder.getName()}] is currently active.`);
}
}
Retrieve all budget orders
function getAllBudgetOrders() {
const budgetOrderIterator = AdsApp.budgetOrders().get();
return budgetOrderIterator;
}
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."],[[["This script provides functions to retrieve budget order information from Google Ads, including the base spending limit, active budget order, and all budget orders."],["`getBaseSpendingLimit()` calculates and logs the base spending limit of each budget order, considering total adjustments."],["`getActiveBudgetOrder()` identifies and logs the currently active budget order within the Google Ads account."],["`getAllBudgetOrders()` retrieves and returns an iterator containing all budget orders associated with the account."]]],[]]