Service
BudgetOrderService
Dependencies
A BudgetOrder links an account wide budget with a BillingAccount.
- Namespace
-
https://adwords.google.com/api/adwords/billing/v201209 - Fields
| Field | Type | Description |
|---|---|---|
| billingAccountId Filterable
Required
Selectable
|
xsd:string
|
This field can be selected using the value "BillingAccountId".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD.
|
| id Filterable
Required
Selectable
|
xsd:long
|
This field can be selected using the value "Id".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : SET, REMOVE.
|
| billingAccountName Billing
Filterable
Selectable
StringLength
|
xsd:string
|
Enables user to specify meaningful name for a billing account to aid in reconciling monthly invoices. This name will be printed in the monthly invoices. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "BillingAccountName". This field can be filtered on. The length of this string should be between 0 and 80, inclusive, (trimmed). |
| poNumber Billing
Filterable
Selectable
StringLength
|
xsd:string
|
Enables user to enter a value that helps them reference this budget order in their monthly invoices. This number will be printed in the monthly invoices. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "PoNumber". This field can be filtered on. The length of this string should be between 0 and 30, inclusive, (trimmed). |
| budgetOrderName Billing
Filterable
Selectable
StringLength
|
xsd:string
|
Enables user to specify meaningful name for referencing this budget order. A default name will be provided if none is specified. This name will be printed in the monthly invoices. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "BudgetOrderName". This field can be filtered on. The length of this string should be between 0 and 40, inclusive, (trimmed). |
| primaryBillingId Billing
Filterable
Selectable
StringLength
|
xsd:string
|
A 12 digit billing id assigned to the user by Google. This can be passed in as "123456789012" or "1234-5678-9012". For mutate.add, this field is required if billingAccountId is not specified. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "PrimaryBillingId". This field can be filtered on. The length of this string should be between 0 and 14, inclusive, (trimmed). |
| secondaryBillingId Billing
Filterable
Selectable
StringLength
|
xsd:string
|
For certain users, a secondary billing id will be required on mutate.add. If this requirement was not communicated to the user, the user may ignore this parameter. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "SecondaryBillingId". This field can be filtered on. The length of this string should be between 0 and 14, inclusive, (trimmed). |
| spendingLimit Filterable
Required
Selectable
|
cm:Money
|
To specify an unlimited budget, set spendingLimit to -1 (in micros),
otherwise spendingLimit must be greater than 0.
This field can be selected using the value "SpendingLimit".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD.
|
| startDateTime Filterable
Required
Selectable
|
xsd:string
|
StartDateTime cannot be in the past,it must be on or before
"20361231 235959 America/Los_Angeles".
This field can be selected using the value "StartDateTime".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD.
|
| endDateTime Filterable
Required
Selectable
|
xsd:string
|
EndDateTime must be on or before "20361231 235959 America/Los_Angeles" or
must set the same instant as "20371230 235959 America/Los_Angeles" to
indicate infinite end date.
This field can be selected using the value "EndDateTime".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD.
|
| lastRequest Billing
ReadOnly
Selectable
|
BudgetOrderRequest
|
lastRequest will contain fields that provide information on the last set of values that were passed in through the parent BudgetOrder for mutate.add and mutate.set. This element only applies if manager account is whitelisted for new billing backend. This field can be selected using the value "LastRequest". This field is read only and should not be set. If this field is sent to the API, it will be ignored. |