[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v26/account_budget_query_builder) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v26/resources/account_budget.proto)

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 (for example, spending limit), these differences are
juxtaposed through '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.

| Attributed resources |
|---|
| [billing_setup](https://developers.google.com/google-ads/api/fields/v26/billing_setup) |
| [customer](https://developers.google.com/google-ads/api/fields/v26/customer) |

Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields **will not segment**
metrics in your `SELECT` clause.

## account_budget.adjusted_spending_limit_micros

Field descriptionOutput only. The adjusted spending limit in micros. One million is
equivalent to one unit.

If the approved spending limit is finite, the adjusted
spending limit may vary depending on the types of adjustments applied
to this budget, if applicable.

The different kinds of adjustments are described here:
<https://support.google.com/google-ads/answer/1704323>

For example, a debit adjustment reduces how much the account is
allowed to spend.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.adjusted_spending_limit_type

Field descriptionOutput only. The adjusted spending limit as a well-defined type, for
example, INFINITE. This will only be populated if the adjusted spending
limit is INFINITE, which is guaranteed to be true if the approved
spending limit is INFINITE.
Category`ATTRIBUTE` Data Type `ENUM`
`INFINITE``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/SpendingLimitTypeEnum.SpendingLimitType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.amount_served_micros

Field descriptionOutput 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).
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.approved_end_date_time

Field descriptionOutput only. The approved end time in yyyy-MM-dd HH:mm:ss format.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.approved_end_time_type

Field descriptionOutput only. The approved end time as a well-defined type, for example,
FOREVER.
Category`ATTRIBUTE` Data Type `ENUM`
`FOREVER``NOW``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/TimeTypeEnum.TimeType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.approved_spending_limit_micros

Field descriptionOutput only. The approved spending limit in micros. One million is
equivalent to one unit. This will only be populated if the proposed
spending limit is finite, and will always be greater than or equal to the
proposed spending limit.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.approved_spending_limit_type

Field descriptionOutput only. The approved spending limit as a well-defined type, for
example, INFINITE. This will only be populated if the approved spending
limit is INFINITE.
Category`ATTRIBUTE` Data Type `ENUM`
`INFINITE``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/SpendingLimitTypeEnum.SpendingLimitType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.approved_start_date_time

Field descriptionOutput 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.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.billing_setup

Field descriptionOutput 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}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.id

Field descriptionOutput only. The ID of the account-level budget.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.name

Field descriptionOutput only. The name of the account-level budget.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.notes

Field descriptionOutput only. Notes associated with the budget.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.account_budget_proposal

Field descriptionOutput only. The resource name of the proposal.
AccountBudgetProposal resource names have the form:

`customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.creation_date_time

Field descriptionOutput only. The time when this account-level budget proposal was
created. Formatted as yyyy-MM-dd HH:mm:ss.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableFalse SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.end_date_time

Field descriptionOutput only. The end time in yyyy-MM-dd HH:mm:ss format.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.end_time_type

Field descriptionOutput only. The end time as a well-defined type, for example, FOREVER.
Category`ATTRIBUTE` Data Type `ENUM`
`FOREVER``NOW``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/TimeTypeEnum.TimeType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.name

Field descriptionOutput only. The name to assign to the account-level budget.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.notes

Field descriptionOutput only. Notes associated with this budget.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.proposal_type

Field descriptionOutput only. The type of this proposal, for example, END to end the
budget associated with this proposal.
Category`ATTRIBUTE` Data Type `ENUM`
`CREATE``END``REMOVE``UNKNOWN``UNSPECIFIED``UPDATE` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/AccountBudgetProposalTypeEnum.AccountBudgetProposalType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.purchase_order_number

Field descriptionOutput only. A purchase order number is a value that helps users
reference this budget in their monthly invoices.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.spending_limit_micros

Field descriptionOutput only. The spending limit in micros. One million is equivalent
to one unit.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.spending_limit_type

Field descriptionOutput only. The spending limit as a well-defined type, for example,
INFINITE.
Category`ATTRIBUTE` Data Type `ENUM`
`INFINITE``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/SpendingLimitTypeEnum.SpendingLimitType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.pending_proposal.start_date_time

Field descriptionOutput only. The start time in yyyy-MM-dd HH:mm:ss format.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableFalse SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.proposed_end_date_time

Field descriptionOutput only. The proposed end time in yyyy-MM-dd HH:mm:ss format.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.proposed_end_time_type

Field descriptionOutput only. The proposed end time as a well-defined type, for example,
FOREVER.
Category`ATTRIBUTE` Data Type `ENUM`
`FOREVER``NOW``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/TimeTypeEnum.TimeType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.proposed_spending_limit_micros

Field descriptionOutput only. The proposed spending limit in micros. One million is
equivalent to one unit.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.proposed_spending_limit_type

Field descriptionOutput only. The proposed spending limit as a well-defined type, for
example, INFINITE.
Category`ATTRIBUTE` Data Type `ENUM`
`INFINITE``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/SpendingLimitTypeEnum.SpendingLimitType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.proposed_start_date_time

Field descriptionOutput 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.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableFalse SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.purchase_order_number

Field descriptionOutput only. A purchase order number is a value that helps users reference
this budget in their monthly invoices.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.resource_name

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

`customers/{customer_id}/accountBudgets/{account_budget_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.status

Field descriptionOutput only. The status of this account-level budget.
Category`ATTRIBUTE` Data Type `ENUM`
`APPROVED``CANCELLED``PENDING``UNKNOWN``UNSPECIFIED` Type URL`https://developers.google.com/google-ads/api/reference/rpc/v26/AccountBudgetStatusEnum.AccountBudgetStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)

## account_budget.total_adjustments_micros

Field descriptionOutput only. The total adjustments amount.

An example of an adjustment is courtesy credits.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v26/account_budget)