BillingSetup

AI-generated Key Takeaways

• A billing setup associates a payments account with a specific advertiser.

• Key fields include resource_name, status, payments_account_info, id, payments_account, start_time (with start_date_time or start_time_type), and end_time (with end_date_time or end_time_type).

• The start_time can be set as a specific date/time or as NOW.

• The end_time is an output-only field 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.