BillingSetup

AI-generated Key Takeaways

• A billing setup connects a payments account and an advertiser and is specific to one advertiser.

• Key fields of a billing setup include its resource name, status, payments account information, ID, the resource name of the payments account, and start and end times.

• The resource_name and the resource name of the payments_account are immutable strings.

• The status and id are output only fields.

• The start_time can be specified as a date and time or as a time type (only NOW is allowed for new setups), and the end_time is output only and is always FOREVER.

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.
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	string 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.