account_budget

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
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 description	Output 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`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.adjusted_spending_limit_type
Field description	Output 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	`google.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.amount_served_micros
Field description	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).
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.approved_end_date_time
Field description	Output only. The approved end time in yyyy-MM-dd HH:mm:ss format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.approved_end_time_type
Field description	Output only. The approved end time as a well-defined type, for example, FOREVER.
Category	`ATTRIBUTE`
Data Type	`ENUM FOREVER NOW UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.TimeTypeEnum.TimeType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.approved_spending_limit_micros
Field description	Output 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`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.approved_spending_limit_type
Field description	Output 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	`google.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.approved_start_date_time
Field description	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.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.billing_setup
Field description	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}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

account_budget.id
Field description	Output only. The ID of the account-level budget.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.name
Field description	Output only. The name of the account-level budget.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.notes
Field description	Output only. Notes associated with the budget.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.account_budget_proposal
Field description	Output 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`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.creation_date_time
Field description	Output 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`
Filterable	False
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.end_date_time
Field description	Output only. The end time in yyyy-MM-dd HH:mm:ss format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.end_time_type
Field description	Output only. The end time as a well-defined type, for example, FOREVER.
Category	`ATTRIBUTE`
Data Type	`ENUM FOREVER NOW UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.TimeTypeEnum.TimeType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.name
Field description	Output only. The name to assign to the account-level budget.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.notes
Field description	Output only. Notes associated with this budget.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.proposal_type
Field description	Output 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	`google.ads.googleads.v18.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.purchase_order_number
Field description	Output 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`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.spending_limit_micros
Field description	Output only. The spending limit in micros. One million is equivalent to one unit.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.spending_limit_type
Field description	Output only. The spending limit as a well-defined type, for example, INFINITE.
Category	`ATTRIBUTE`
Data Type	`ENUM INFINITE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.pending_proposal.start_date_time
Field description	Output only. The start time in yyyy-MM-dd HH:mm:ss format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	False
Selectable	True
Sortable	True
Repeated	False

account_budget.proposed_end_date_time
Field description	Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.proposed_end_time_type
Field description	Output only. The proposed end time as a well-defined type, for example, FOREVER.
Category	`ATTRIBUTE`
Data Type	`ENUM FOREVER NOW UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.TimeTypeEnum.TimeType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.proposed_spending_limit_micros
Field description	Output only. The proposed spending limit in micros. One million is equivalent to one unit.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.proposed_spending_limit_type
Field description	Output only. The proposed spending limit as a well-defined type, for example, INFINITE.
Category	`ATTRIBUTE`
Data Type	`ENUM INFINITE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.proposed_start_date_time
Field description	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.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	False
Selectable	True
Sortable	True
Repeated	False

account_budget.purchase_order_number
Field description	Output 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`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.resource_name
Field description	Output 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`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

account_budget.status
Field description	Output only. The status of this account-level budget.
Category	`ATTRIBUTE`
Data Type	`ENUM APPROVED CANCELLED PENDING UNKNOWN UNSPECIFIED`
Type URL	`google.ads.googleads.v18.enums.AccountBudgetStatusEnum.AccountBudgetStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget.total_adjustments_micros
Field description	Output only. The total adjustments amount. An example of an adjustment is courtesy credits.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

account_budget

account_budget.adjusted_spending_limit_micros

account_budget.adjusted_spending_limit_type

account_budget.amount_served_micros

account_budget.approved_end_date_time

account_budget.approved_end_time_type

account_budget.approved_spending_limit_micros

account_budget.approved_spending_limit_type

account_budget.approved_start_date_time

account_budget.billing_setup

account_budget.id

account_budget.name

account_budget.notes

account_budget.pending_proposal.account_budget_proposal

account_budget.pending_proposal.creation_date_time

account_budget.pending_proposal.end_date_time

account_budget.pending_proposal.end_time_type

account_budget.pending_proposal.name

account_budget.pending_proposal.notes

account_budget.pending_proposal.proposal_type

account_budget.pending_proposal.purchase_order_number

account_budget.pending_proposal.spending_limit_micros

account_budget.pending_proposal.spending_limit_type

account_budget.pending_proposal.start_date_time

account_budget.proposed_end_date_time

account_budget.proposed_end_time_type

account_budget.proposed_spending_limit_micros

account_budget.proposed_spending_limit_type

account_budget.proposed_start_date_time

account_budget.purchase_order_number

account_budget.resource_name

account_budget.status

account_budget.total_adjustments_micros