Google Ads API is returning to beta status. Please read our blog post for more details.

account_budget

The account budget in the query.
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 (if exist).

account_budget.adjusted_spending_limit_micros

Field descriptionThe 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 URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.adjusted_spending_limit_type

Field descriptionThe adjusted spending limit as a well-defined type, e.g. 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.v1.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.amount_served_micros

Field descriptionThe 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 URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_end_date_time

Field descriptionThe approved end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_end_time_type

Field descriptionThe approved end time as a well-defined type, e.g. FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_spending_limit_micros

Field descriptionThe 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 URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_spending_limit_type

Field descriptionThe approved spending limit as a well-defined type, e.g. INFINITE. This will only be populated if the approved spending limit is INFINITE.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.approved_start_date_time

Field descriptionThe 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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.billing_setup

Field descriptionThe 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 URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

account_budget.id

Field descriptionThe ID of the account-level budget.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.name

Field descriptionThe name of the account-level budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.notes

Field descriptionNotes associated with the budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.account_budget_proposal

Field descriptionThe resource name of the proposal. AccountBudgetProposal resource names have the form: `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.creation_date_time

Field descriptionThe time when this account-level budget proposal was created. Formatted as yyyy-MM-dd HH:mm:ss.
CategoryATTRIBUTE
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.end_date_time

Field descriptionThe end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.end_time_type

Field descriptionThe end time as a well-defined type, e.g. FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.name

Field descriptionThe name to assign to the account-level budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.notes

Field descriptionNotes associated with this budget.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.proposal_type

Field descriptionThe type of this proposal, e.g. END to end the budget associated with this proposal.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.purchase_order_number

Field descriptionA purchase order number is a value that helps users reference this budget in their monthly invoices.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.spending_limit_micros

Field descriptionThe spending limit in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.spending_limit_type

Field descriptionThe spending limit as a well-defined type, e.g. INFINITE.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.pending_proposal.start_date_time

Field descriptionThe start time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_end_date_time

Field descriptionThe proposed end time in yyyy-MM-dd HH:mm:ss format.
CategoryATTRIBUTE
Data TypeDATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_end_time_type

Field descriptionThe proposed end time as a well-defined type, e.g. FOREVER.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.TimeTypeEnum.TimeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_spending_limit_micros

Field descriptionThe proposed spending limit in micros. One million is equivalent to one unit.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_spending_limit_type

Field descriptionThe proposed spending limit as a well-defined type, e.g. INFINITE.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.proposed_start_date_time

Field descriptionThe 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 URLgoogle.protobuf.StringValue
FilterableFalse
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.purchase_order_number

Field descriptionA purchase order number is a value that helps users reference this budget in their monthly invoices.
CategoryATTRIBUTE
Data TypeSTRING
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.resource_name

Field descriptionThe 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 descriptionThe status of this account-level budget.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v1.enums.AccountBudgetStatusEnum.AccountBudgetStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

account_budget.total_adjustments_micros

Field descriptionThe total adjustments amount. An example of an adjustment is courtesy credits.
CategoryATTRIBUTE
Data TypeINT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse