Service
BudgetService
CampaignService
MutateJobService
Dependencies
Budgets are used for managing the amount of money spent on AdWords.
- Namespace
-
https://adwords.google.com/api/adwords/cm/v201302 - Fields
| Field | Type | Description |
|---|---|---|
| budgetId Filterable
Selectable
|
xsd:long
|
A Budget is created using the BudgetService ADD operation and is assigned a BudgetId. The BudgetId is used when modifying the Budget with BudgetService, or associating the Budget to a Campaign with CampaignService. A BudgetId can be shared across different campaigns--the system will then allocate the Budget among the Campaigns to get the optimum result. This field can be selected using the value "BudgetId". This field can be filtered on. |
| name Filterable
Selectable
StringLength
|
xsd:string
|
Name of the Budget. Every Budget must have a non-null non-empty name. In addition, all budget names owned by an account must be distinct. This field can be selected using the value "BudgetName". This field can be filtered on. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes. |
| period Selectable
|
Budget.BudgetPeriod
|
Period over which to spend the budget. MONTHLY is not available to most users.
This field can be selected using the value "Period".
Enumerations
|
| amount Filterable
InRange
Selectable
|
Money
|
Amount of budget in the local currency for the account. This field can be selected using the value "Amount". This field can be filtered on. This field must be greater than or equal to 1. |
| deliveryMethod Selectable
|
Budget.BudgetDeliveryMethod
|
Delivery method for the budget.
This field can be selected using the value "DeliveryMethod".
Enumerations
|
| referenceCount ReadOnly
Selectable
|
xsd:int
|
Number of campaigns actively using this budget. This field is only populated for Get operations. This field can be selected using the value "BudgetReferenceCount". This field is read only and should not be set. If this field is sent to the API, it will be ignored. |
| isExplicitlyShared Filterable
Selectable
|
xsd:boolean
|
If true, this budget was created through the BudgetService
or through the UI shared library with the purpose of sharing
this budget across one or more campaigns.
If false, this budget was created with the intention to be dedicatedly used with a single campaign, and the Budget's name and status will stay in the sync with the associated Campaign's name and status. Sharing this budget with a second Campaign will flip this field to true. This field can be selected using the value "IsBudgetExplicitlyShared". This field can be filtered on. |
| status Filterable
ReadOnly
Selectable
|
Budget.BudgetStatus
|
This field can be selected using the value "BudgetStatus".
This field can be filtered on.
This field is read only and should not be set. If this field is sent to the API, it will be ignored.
Enumerations
|
| associatedCampaigns ReadOnly
|
AssociatedCampaign[]
|
List of campaigns that are associated with this budget. This field is read only and should not be set. If this field is sent to the API, it will be ignored. |