Page Summary
-
The provided code snippets demonstrate how to retrieve various types of budget order information using the AdsApp in Google Ads scripts.
-
One function shows how to calculate the base spending limit for each budget order, accounting for unlimited limits or adjustments.
-
Another function illustrates how to specifically retrieve the currently active budget order.
-
A simple function is provided to retrieve all available budget orders.
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 ; }
