account_budget

Help me build a query

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 description Output 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. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.adjusted_spending_limit_type Field description Output 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. Category ATTRIBUTE Data Type ENUM INFINITE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False

account_budget.amount_served_micros Field description Output 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). Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.approved_end_date_time Field description Output only. The approved end time in yyyy-MM-dd HH:mm:ss format. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.approved_end_time_type Field description Output only. The approved end time as a well-defined type, for example, FOREVER. Category ATTRIBUTE Data Type ENUM FOREVER NOW UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.TimeTypeEnum.TimeType Filterable True Selectable True Sortable True Repeated False

account_budget.approved_spending_limit_micros Field description Output 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. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.approved_spending_limit_type Field description Output 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. Category ATTRIBUTE Data Type ENUM INFINITE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False

account_budget.approved_start_date_time Field description Output 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. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.billing_setup Field description Output 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} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

account_budget.id Field description Output only. The ID of the account-level budget. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.name Field description Output only. The name of the account-level budget. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.notes Field description Output only. Notes associated with the budget. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.account_budget_proposal Field description Output only. The resource name of the proposal. AccountBudgetProposal resource names have the form: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.creation_date_time Field description Output only. The time when this account-level budget proposal was created. Formatted as yyyy-MM-dd HH:mm:ss. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable False Selectable True Sortable True Repeated False

account_budget.pending_proposal.end_date_time Field description Output only. The end time in yyyy-MM-dd HH:mm:ss format. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.end_time_type Field description Output only. The end time as a well-defined type, for example, FOREVER. Category ATTRIBUTE Data Type ENUM FOREVER NOW UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.TimeTypeEnum.TimeType Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.name Field description Output only. The name to assign to the account-level budget. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.notes Field description Output only. Notes associated with this budget. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.proposal_type Field description Output only. The type of this proposal, for example, END to end the budget associated with this proposal. Category ATTRIBUTE Data Type ENUM CREATE END REMOVE UNKNOWN UNSPECIFIED UPDATE Type URL google.ads.googleads.v17.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.purchase_order_number Field description Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.spending_limit_micros Field description Output only. The spending limit in micros. One million is equivalent to one unit. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.spending_limit_type Field description Output only. The spending limit as a well-defined type, for example, INFINITE. Category ATTRIBUTE Data Type ENUM INFINITE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False

account_budget.pending_proposal.start_date_time Field description Output only. The start time in yyyy-MM-dd HH:mm:ss format. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable False Selectable True Sortable True Repeated False

account_budget.proposed_end_date_time Field description Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.proposed_end_time_type Field description Output only. The proposed end time as a well-defined type, for example, FOREVER. Category ATTRIBUTE Data Type ENUM FOREVER NOW UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.TimeTypeEnum.TimeType Filterable True Selectable True Sortable True Repeated False

account_budget.proposed_spending_limit_micros Field description Output only. The proposed spending limit in micros. One million is equivalent to one unit. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.proposed_spending_limit_type Field description Output only. The proposed spending limit as a well-defined type, for example, INFINITE. Category ATTRIBUTE Data Type ENUM INFINITE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.SpendingLimitTypeEnum.SpendingLimitType Filterable True Selectable True Sortable True Repeated False

account_budget.proposed_start_date_time Field description Output 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. Category ATTRIBUTE Data Type DATE Type URL N/A Filterable False Selectable True Sortable True Repeated False

account_budget.purchase_order_number Field description Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

account_budget.resource_name Field description Output only. The resource name of the account-level budget. AccountBudget resource names have the form: customers/{customer_id}/accountBudgets/{account_budget_id} Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

account_budget.status Field description Output only. The status of this account-level budget. Category ATTRIBUTE Data Type ENUM APPROVED CANCELLED PENDING UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v17.enums.AccountBudgetStatusEnum.AccountBudgetStatus Filterable True Selectable True Sortable True Repeated False

account_budget.total_adjustments_micros Field description Output only. The total adjustments amount. An example of an adjustment is courtesy credits. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False