Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
Send feedback
account_budget_proposal
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition An account-level budget proposal.
All fields prefixed with 'proposed' may not necessarily be applied directly.
For example, proposed spending limits may be adjusted before their
application. This is true if the 'proposed' field has an 'approved'
counterpart, for example, spending limits.
Note that the proposal type (proposal_type) changes which fields are
required and which must remain empty.
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_proposal.account_budget
Field description Immutable. The resource name of the account-level budget associated with
this proposal.
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approval_date_time
Field description Output only. The date time when this account-level budget was approved, if
applicable.
Category ATTRIBUTEData Type DATEType URL N/AFilterable False Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approved_end_date_time
Field description Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format.
Category ATTRIBUTEData Type DATEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approved_end_time_type
Field description Output only. The approved end date time as a well-defined type, for
example, FOREVER.
Category ATTRIBUTEData Type
ENUM
FOREVER
NOW
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.TimeTypeEnum.TimeType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approved_spending_limit_micros
Field description Output only. The approved spending limit in micros. One million is
equivalent to one unit.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approved_spending_limit_type
Field description Output only. The approved spending limit as a well-defined type, for
example, INFINITE.
Category ATTRIBUTEData Type
ENUM
INFINITE
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.approved_start_date_time
Field description Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format.
Category ATTRIBUTEData Type DATEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.billing_setup
Field description Immutable. The resource name of the billing setup associated with this
proposal.
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.creation_date_time
Field description Output only. The date time when this account-level budget proposal was
created, which is not the same as its approval date time, if applicable.
Category ATTRIBUTEData Type DATEType URL N/AFilterable False Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.id
Field description Output only. The ID of the proposal.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposal_type
Field description Immutable. The type of this proposal, for example, END to end the budget
associated with this proposal.
Category ATTRIBUTEData Type
ENUM
CREATE
END
REMOVE
UNKNOWN
UNSPECIFIED
UPDATE
Type URL google.ads.googleads.v26.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_end_date_time
Field description Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format.
Category ATTRIBUTEData Type DATEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_end_time_type
Field description Immutable. The proposed end date time as a well-defined type, for
example, FOREVER.
Category ATTRIBUTEData Type
ENUM
FOREVER
NOW
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.TimeTypeEnum.TimeType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_name
Field description Immutable. The name to assign to the account-level budget.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_notes
Field description Immutable. Notes associated with this budget.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_purchase_order_number
Field description Immutable. A purchase order number is a value that enables the user to help
them reference this budget in their monthly invoices.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_spending_limit_micros
Field description Immutable. The proposed spending limit in micros. One million is
equivalent to one unit.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_spending_limit_type
Field description Immutable. The proposed spending limit as a well-defined type, for
example, INFINITE.
Category ATTRIBUTEData Type
ENUM
INFINITE
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.proposed_start_date_time
Field description Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format.
Category ATTRIBUTEData Type DATEType URL N/AFilterable False Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.resource_name
Field description Immutable. The resource name of the proposal.
AccountBudgetProposal resource names have the form:
customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
account_budget_proposal.status
Field description Output only. The status of this proposal.
When a new proposal is created, the status defaults to PENDING.
Category ATTRIBUTEData Type
ENUM
APPROVED
APPROVED_HELD
CANCELLED
PENDING
REJECTED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-14 UTC."],[],[]]
