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 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.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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).
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_end_date_time

Field descriptionOutput only. The approved end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_end_time_type

Field descriptionOutput only. The approved end time as a well-defined type, for example, FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

account_budget.id

Field descriptionOutput only. The ID of the account-level budget.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.name

Field descriptionOutput only. The name of the account-level budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.notes

Field descriptionOutput only. Notes associated with the budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.end_date_time

Field descriptionOutput only. The end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.end_time_type

Field descriptionOutput only. The end time as a well-defined type, for example, FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.name

Field descriptionOutput only. The name to assign to the account-level budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.notes

Field descriptionOutput only. Notes associated with this budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.spending_limit_micros

Field descriptionOutput only. The spending limit in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.spending_limit_type

Field descriptionOutput only. The spending limit as a well-defined type, for example, INFINITE.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.start_date_time

Field descriptionOutput only. The start time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_end_date_time

Field descriptionOutput only. The proposed end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_end_time_type

Field descriptionOutput only. The proposed end time as a well-defined type, for example, FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_spending_limit_micros

Field descriptionOutput only. The proposed spending limit in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_spending_limit_type

Field descriptionOutput only. The proposed spending limit as a well-defined type, for example, INFINITE.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

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.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

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}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

account_budget.status

Field descriptionOutput only. The status of this account-level budget.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v18.enums.AccountBudgetStatusEnum.AccountBudgetStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.total_adjustments_micros

Field descriptionOutput only. The total adjustments amount. An example of an adjustment is courtesy credits.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse