Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

AccountBudget

An account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pending_proposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (e.g. spending limit), these differences are juxtaposed via 'proposed_', 'approved_', and possibly 'adjusted_' fields.

This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pending_proposal.

Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.

Fields

resource_name

string

Output only. The resource name of the account-level budget. AccountBudget resource names have the form:

customers/{customer_id}/accountBudgets/{account_budget_id}

status

AccountBudgetStatus

Output only. The status of this account-level budget.

total_adjustments_micros

int64

Output only. The total adjustments amount.

An example of an adjustment is courtesy credits.

amount_served_micros

int64

Output only. The value of Ads that have been served, in micros.

This includes overdelivery costs, in which case a credit might be automatically applied to the budget (see total_adjustments_micros).

pending_proposal

PendingAccountBudgetProposal

Output only. The pending proposal to modify this budget, if applicable.

id

int64

Output only. The ID of the account-level budget.

billing_setup

string

Output only. The resource name of the billing setup associated with this account-level budget. BillingSetup resource names have the form:

customers/{customer_id}/billingSetups/{billing_setup_id}

name

string

Output only. The name of the account-level budget.

proposed_start_date_time

string

Output only. The proposed start time of the account-level budget in yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, this is the time of request.

approved_start_date_time

string

Output only. The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss format.

For example, if a new budget is approved after the proposed start time, the approved start time is the time of approval.

purchase_order_number

string

Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices.