billing_setup
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
A billing setup, which associates a payments account and an advertiser. A
billing setup is specific to one advertiser.
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 description Output 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.end_time_type
Field description Output 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.id
Field description Output only. The ID of the billing setup.
Category ATTRIBUTE
Data Type INT64
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account
Field description Immutable. 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account_info.payments_account_id
Field description Output 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account_info.payments_account_name
Field description Immutable. 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account_info.payments_profile_id
Field description Immutable. 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account_info.payments_profile_name
Field description Output only. The name of the payments profile associated with the billing
setup.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.payments_account_info.secondary_payments_profile_id
Field description Output 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
Filterable True
Selectable True
Sortable True
Repeated False
billing_setup.resource_name
Field description Immutable. 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
Filterable True
Selectable True
Sortable False
Repeated False
billing_setup.start_date_time
Field description Immutable. 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
Filterable True
Selectable True
Sortable True
Repeated False
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-09-24 UTC.
[null,null,["Last updated 2026-09-24 UTC."],[],[]]