A billing setup, which associates a payments account and an advertiser. A billing setup is specific to one advertiser.
JSON representation |
---|
{ "resourceName": string, "status": enum ( |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the billing setup. BillingSetup resource names have the form:
|
status |
Output only. The status of the billing setup. |
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 paymentsAccount should not be set). When getting a billing setup, this and paymentsAccount will be populated. |
id |
Output only. The ID of the billing setup. |
paymentsAccount |
Immutable. The resource name of the payments account associated with this billing setup. Payments resource names have the form:
|
Union field 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. |
|
startDateTime |
Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a future time is allowed. |
startTimeType |
Immutable. The start time as a type. Only NOW is allowed. |
Union field 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: |
|
endDateTime |
Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. |
endTimeType |
Output only. The end time as a type. The only possible value is FOREVER. |
BillingSetupStatus
The possible statuses of a BillingSetup.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
PENDING |
The billing setup is pending approval. |
APPROVED_HELD |
The billing setup has been approved but the corresponding first budget has not. This can only occur for billing setups configured for monthly invoicing. |
APPROVED |
The billing setup has been approved. |
CANCELLED |
The billing setup was cancelled by the user prior to approval. |
PaymentsAccountInfo
Container of payments account information for this billing.
JSON representation |
---|
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string } |
Fields | |
---|---|
paymentsAccountId |
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". |
paymentsAccountName |
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. |
paymentsProfileId |
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". |
paymentsProfileName |
Output only. The name of the payments profile associated with the billing setup. |
secondaryPaymentsProfileId |
Output only. A secondary payments profile id present in uncommon situations, for example, when a sequential liability agreement has been arranged. |