AdsApp.​BudgetOrder

Represents a Google Ads budget order. Budget orders are used for managing client budgets at the account level.

Each budget order is associated with a billing account which can take invoices for consolidated billing. For details about budget orders and billing accounts, see Billing.

Methods:

MemberTypeDescription
getBillingAccount AdsApp.BillingAccount Returns the associated billing account.
getEndDateTime AdsApp.GoogleAdsDate Returns the budget order's end date or null if there is no end date.
getId String Returns the ID of the budget order.
getName String Returns the name of the budget order.
getPoNumber String Returns the purchase order number or null if there is no purchase order number.
getResourceName String Returns the resource name of the budget order.
getSpendingLimit double Returns the effective spending limit in the account's currency, including all adjustments that have been applied to the budget order.
getStartDateTime AdsApp.GoogleAdsDate Returns the budget order's start date.
getTotalAdjustments double Returns the total adjustments that have been applied to the spending limit, in the account's currency.

getBillingAccount()

Returns the associated billing account. Will be null if billing setup is still pending.

Return values:

TypeDescription
AdsApp.BillingAccount The budget order's start date.

getEndDateTime()

Returns the budget order's end date or null if there is no end date.

Return values:

TypeDescription
AdsApp.GoogleAdsDate The budget order's end date or null if there is no end date.

getId()

Returns the ID of the budget order.

Return values:

TypeDescription
String The ID of the budget order.

getName()

Returns the name of the budget order.

Return values:

TypeDescription
String Name of the budget order.

getPoNumber()

Returns the purchase order number or null if there is no purchase order number.

Return values:

TypeDescription
String The purchase order number or null if there is no purchase order number.

getResourceName()

Returns the resource name of the budget order.

Return values:

TypeDescription
String The resource name of the budget order.

getSpendingLimit()

Returns the effective spending limit in the account's currency, including all adjustments that have been applied to the budget order. null indicates no limits. Code example.

Return values:

TypeDescription
double The effective spending limit or null if there is no limit.

getStartDateTime()

Returns the budget order's start date.

Return values:

TypeDescription
AdsApp.GoogleAdsDate The budget order's start date.

getTotalAdjustments()

Returns the total adjustments that have been applied to the spending limit, in the account's currency. To get the base spending limit, subtract this from the effective spending limit. null indicates no adjustments have been applied.

Return values:

TypeDescription
double The net sum of adjustments since the creation of the budget order.