AccountBudgetProposal
Stay organized with collections
Save and categorize content based on your preferences.
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 |
resource_name
|
string
Immutable. The resource name of the proposal. AccountBudgetProposal resource names have the form: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
|
proposal_type
|
AccountBudgetProposalType
Immutable. The type of this proposal, for example, END to end the budget associated with this proposal.
|
status
|
AccountBudgetProposalStatus
Output only. The status of this proposal. When a new proposal is created, the status defaults to PENDING.
|
id
|
int64
Output only. The ID of the proposal.
|
billing_setup
|
string
Immutable. The resource name of the billing setup associated with this proposal.
|
account_budget
|
string
Immutable. The resource name of the account-level budget associated with this proposal.
|
proposed_name
|
string
Immutable. The name to assign to the account-level budget.
|
approved_start_date_time
|
string
Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format.
|
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_notes
|
string
Immutable. Notes associated with this budget.
|
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.
|
approval_date_time
|
string
Output only. The date time when this account-level budget was approved, if applicable.
|
Union field proposed_start_time
proposed_start_time . 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.
|
Union field proposed_end_time
proposed_end_time . 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.
|
Union field approved_end_time
approved_end_time . 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.
|
Union field proposed_spending_limit
proposed_spending_limit . 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.
|
Union field approved_spending_limit
approved_spending_limit . 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.
|
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 2025-08-07 UTC.
[null,null,["Last updated 2025-08-07 UTC."],[],[],null,["# AccountBudgetProposal\n\nAn account-level budget proposal.\n\nAll 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.\n\nNote that the proposal type (proposal_type) changes which fields are required and which must remain empty.\n\n| Fields ||\n|--------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `resource_name` | `string` Immutable. The resource name of the proposal. AccountBudgetProposal resource names have the form: `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` |\n| ### `proposal_type` | [AccountBudgetProposalType](/google-ads/api/reference/rpc/v21/AccountBudgetProposalTypeEnum.AccountBudgetProposalType) Immutable. The type of this proposal, for example, END to end the budget associated with this proposal. |\n| ### `status` | [AccountBudgetProposalStatus](/google-ads/api/reference/rpc/v21/AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus) Output only. The status of this proposal. When a new proposal is created, the status defaults to PENDING. |\n| ### `id` | `int64` Output only. The ID of the proposal. |\n| ### `billing_setup` | `string` Immutable. The resource name of the billing setup associated with this proposal. |\n| ### `account_budget` | `string` Immutable. The resource name of the account-level budget associated with this proposal. |\n| ### `proposed_name` | `string` Immutable. The name to assign to the account-level budget. |\n| ### `approved_start_date_time` | `string` Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format. |\n| ### `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. |\n| ### `proposed_notes` | `string` Immutable. Notes associated with this budget. |\n| ### `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. |\n| ### `approval_date_time` | `string` Output only. The date time when this account-level budget was approved, if applicable. |\n| Union field ### `proposed_start_time` `proposed_start_time`. 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: ||\n| ### `proposed_start_date_time` | `string` Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format. |\n| ### `proposed_start_time_type` | [TimeType](/google-ads/api/reference/rpc/v21/TimeTypeEnum.TimeType) Immutable. The proposed start date time as a well-defined type, for example, NOW. |\n| Union field ### `proposed_end_time` `proposed_end_time`. 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: ||\n| ### `proposed_end_date_time` | `string` Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format. |\n| ### `proposed_end_time_type` | [TimeType](/google-ads/api/reference/rpc/v21/TimeTypeEnum.TimeType) Immutable. The proposed end date time as a well-defined type, for example, FOREVER. |\n| Union field ### `approved_end_time` `approved_end_time`. The approved end date time of the account-level budget. `approved_end_time` can be only one of the following: ||\n| ### `approved_end_date_time` | `string` Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format. |\n| ### `approved_end_time_type` | [TimeType](/google-ads/api/reference/rpc/v21/TimeTypeEnum.TimeType) Output only. The approved end date time as a well-defined type, for example, FOREVER. |\n| Union field ### `proposed_spending_limit` `proposed_spending_limit`. The proposed spending limit. `proposed_spending_limit` can be only one of the following: ||\n| ### `proposed_spending_limit_micros` | `int64` Immutable. The proposed spending limit in micros. One million is equivalent to one unit. |\n| ### `proposed_spending_limit_type` | [SpendingLimitType](/google-ads/api/reference/rpc/v21/SpendingLimitTypeEnum.SpendingLimitType) Immutable. The proposed spending limit as a well-defined type, for example, INFINITE. |\n| Union field ### `approved_spending_limit` `approved_spending_limit`. The approved spending limit. `approved_spending_limit` can be only one of the following: ||\n| ### `approved_spending_limit_micros` | `int64` Output only. The approved spending limit in micros. One million is equivalent to one unit. |\n| ### `approved_spending_limit_type` | [SpendingLimitType](/google-ads/api/reference/rpc/v21/SpendingLimitTypeEnum.SpendingLimitType) Output only. The approved spending limit as a well-defined type, for example, INFINITE. |"]]