> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v25** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/AccountBudgetProposal).

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.

[Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v25/resources/account_budget_proposal.proto)

| Fields ||
|---|---|
| ## `account_budget` | `string` Immutable. The resource name of the account-level budget associated with this proposal. |
| ## `approval_date_time` | `string` Output only. The date time when this account-level budget was approved, if applicable. |
| ## `approved_end_time` Union field. The approved end date time of the account-level budget. `approved_end_time` can be only one of the following: ||
| ### `approved_end_date_time` | `string` Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format. |
| ### `approved_end_time_type` | `TimeType` Output only. The approved end date time as a well-defined type, for example, FOREVER. |
| ## `approved_spending_limit` Union field. The approved spending limit. `approved_spending_limit` can be only one of the following: ||
| ### `approved_spending_limit_micros` | `int64` Output only. The approved spending limit in micros. One million is equivalent to one unit. |
| ### `approved_spending_limit_type` | `SpendingLimitType` Output only. The approved spending limit as a well-defined type, for example, INFINITE. |
| ## `approved_start_date_time` | `string` Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format. |
| ## `billing_setup` | `string` Immutable. The resource name of the billing setup associated with this proposal. |
| ## `creation_date_time` | `string` 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. |
| ## `id` | `int64` Output only. The ID of the proposal. |
| ## `proposal_type` | `AccountBudgetProposalType` Immutable. The type of this proposal, for example, END to end the budget associated with this proposal. |
| ## `proposed_end_time` Union field. The proposed end date time of the account-level budget, which cannot be in the past. `proposed_end_time` can be only one of the following: ||
| ### `proposed_end_date_time` | `string` Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format. |
| ### `proposed_end_time_type` | `TimeType` Immutable. The proposed end date time as a well-defined type, for example, FOREVER. |
| ## `proposed_name` | `string` Immutable. The name to assign to the account-level budget. |
| ## `proposed_notes` | `string` Immutable. Notes associated with this budget. |
| ## `proposed_purchase_order_number` | `string` Immutable. A purchase order number is a value that enables the user to help them reference this budget in their monthly invoices. |
| ## `proposed_spending_limit` Union field. The proposed spending limit. `proposed_spending_limit` can be only one of the following: ||
| ### `proposed_spending_limit_micros` | `int64` Immutable. The proposed spending limit in micros. One million is equivalent to one unit. |
| ### `proposed_spending_limit_type` | `SpendingLimitType` Immutable. The proposed spending limit as a well-defined type, for example, INFINITE. |
| ## `proposed_start_time` Union field. The proposed start date time of the account-level budget, which cannot be in the past. `proposed_start_time` can be only one of the following: ||
| ### `proposed_start_date_time` | `string` Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format. |
| ### `proposed_start_time_type` | `TimeType` Immutable. The proposed start date time as a well-defined type, for example, NOW. |
| ## `resource_name` | `string` Immutable. The resource name of the proposal. AccountBudgetProposal resource names have the form: `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` |
| ## `status` | `AccountBudgetProposalStatus` Output only. The status of this proposal. When a new proposal is created, the status defaults to PENDING. |