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

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v24/billing_setup_query_builder.md.txt) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v24/resources/billing_setup.proto)

A billing setup, which associates a payments account and an advertiser. A
billing setup is specific to one advertiser.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v24/customer.md.txt) |

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.

## billing_setup.end_date_time

Field descriptionOutput only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss
format.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.end_time_type

Field descriptionOutput only. The end time as a type. The only possible value is FOREVER.
Category`ATTRIBUTE` Data Type `ENUM`
`FOREVER``NOW``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v24.enums.TimeTypeEnum.TimeType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.id

Field descriptionOutput only. The ID of the billing setup.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account

Field descriptionImmutable. The resource name of the payments account associated with this
billing setup. Payments resource names have the form:

`customers/{customer_id}/paymentsAccounts/{payments_account_id}`
When setting up billing, this is used to signup with an existing payments
account (and then payments_account_info should not be set).
When getting a billing setup, this and payments_account_info will be
populated.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account_info.payments_account_id

Field descriptionOutput only. A 16 digit id used to identify the payments account
associated with the billing setup.

This must be passed as a string with dashes, for example,
"1234-5678-9012-3456".
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account_info.payments_account_name

Field descriptionImmutable. The name of the payments account associated with the billing
setup.

This enables the user to specify a meaningful name for a payments account
to aid in reconciling monthly invoices.

This name will be printed in the monthly invoices.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account_info.payments_profile_id

Field descriptionImmutable. A 12 digit id used to identify the payments profile associated
with the billing setup.

This must be passed in as a string with dashes, for example,
"1234-5678-9012".
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account_info.payments_profile_name

Field descriptionOutput only. The name of the payments profile associated with the billing
setup.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.payments_account_info.secondary_payments_profile_id

Field descriptionOutput only. A secondary payments profile id present in uncommon
situations, for example, when a sequential liability agreement has been
arranged.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.resource_name

Field descriptionImmutable. The resource name of the billing setup.
BillingSetup resource names have the form:

`customers/{customer_id}/billingSetups/{billing_setup_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.start_date_time

Field descriptionImmutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss
format. Only a future time is allowed.
Category`ATTRIBUTE` Data Type`DATE` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)

## billing_setup.status

Field descriptionOutput only. The status of the billing setup.
Category`ATTRIBUTE` Data Type `ENUM`
`APPROVED``APPROVED_HELD``CANCELLED``PENDING``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v24.enums.BillingSetupStatusEnum.BillingSetupStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[account_budget](https://developers.google.com/google-ads/api/fields/v24/account_budget.md.txt) [account_budget_proposal](https://developers.google.com/google-ads/api/fields/v24/account_budget_proposal.md.txt) [billing_setup](https://developers.google.com/google-ads/api/fields/v24/billing_setup.md.txt)