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}

id

Int64Value

Output only. The ID of the billing setup.

status

BillingSetupStatus

Output only. The status of the billing setup.

payments_account

StringValue

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.

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.

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

StringValue

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

start_time_type

TimeType

Immutable. The start time as a type. Only NOW is allowed.

Union field

end_time

end_time. When the billing setup ends / ended. This is either FOREVER or the start time of the next scheduled billing setup. end_time can be only one of the following:

end_date_time

StringValue

Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format.

end_time_type

TimeType

Output only. The end time as a type. The only possible value is FOREVER.