Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

BillingSetup

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

Fields

resource_name

string

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

customers/{customer_id}/billingSetups/{billing_setup_id}

status

BillingSetupStatus

Output only. The status of the billing setup.

payments_account_info

PaymentsAccountInfo

Immutable. The payments account information associated with this billing setup. When setting up billing, this is used to signup with a new payments account (and then payments_account should not be set). When getting a billing setup, this and payments_account will be populated.

id

int64

Output only. The ID of the billing setup.

payments_account

string

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.

start_time

Union field start_time. When creating a new billing setup, this is when the setup should take effect. NOW is the only acceptable start time if the customer doesn't have any approved setups.

start_time. When creating a new billing setup, this is when the setup should take effect. NOW is the only acceptable start time if the customer doesn't have any approved setups.

When fetching an existing billing setup, this is the requested start time. However, if the setup was approved (see status) after the requested start time, then this is the approval time. start_time can be only one of the following:

start_time can be only one of the following:

start_date_time

string

Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a future time is allowed.