API Rate Sheet
API Operations Rate Sheet Table
Each request called on an AdWords account consumes a certain number of API units,
as specified in the rate sheet below. This rate sheet includes requests for all
available versions of the AdWords API. While some requests consume just one unit,
others consume more. Some are charged "per item", others are charged than "per call".
Costs are charged at a rate of:
US$0.25 (or local currency equivalent) per thousand API units consumed
Some advertisers who develop proprietary
applications to promote their own businesses may be eligible for limited free
allocations of API units.
Costs listed in the table are "per call" unless noted as "per item".
- per call - A single cost for a given API request.
For example, the request
updateAdGroup
has a cost of 10 API units per call.
- per item - A cost that applies once to each "base" item
being operated on, typically an element in an array.
For example, the request
updateAdGroupList
has a cost of 10 API units per item, where an "item" is an ad group.
If you're updating a list of 20 ad groups with this single request,
the cost of that request would be 10 API units x 20 items
or 200 API units, which is US$0.05.
Items are counted as:
-
elements in an array passed in as an argument to the request.
Example: For
addAds,
count the elements in Ad[] passed in.
-
elements in an array returned in the response to the request.
Example:
For getClientAccounts,
count the elements in string[] returned.
NOTE - If a request takes an array as an argument and returns an array
of a different size, the number of items is equal to the size of the larger array.
-
underlying elements in an array within an object, such as keyword requests
within adgroup requests or campaign requests.
Example: For
estimateAdGroupList
count the elements in KeywordRequest[] in
AdGroupRequest[] passed in.
The asterisk (*) indicates the request is deprecated in some available version of the AdWords API. Deprecated means that request is still in use in some version but will likely be removed in a later version of the AdWords API.
Batch requests are atomic, meaning they successfully process either all elements or
none of them. If some elements fail due to constraint checks, you are charged only
for items that failed. So if you used addAd to try to add 10 ads
and 3 of them failed PCF checks, then you would be charged for 3 addAd
calls, not 10.
Show or hide requests with cost 1 API unit
| |
| AccountService |
| getAccountInfo |
1 |
|
| getClientAccounts |
1 |
per item |
| setLoginInfo * |
1 |
|
| updateAccountInfo |
1 |
|
| AdGroupService |
| addAdGroup |
1 |
|
| addAdGroupList |
1 |
per item |
| getAdGroup |
1 |
|
| getAdGroupList |
1 |
per item |
| getAdGroupStats |
1 |
per item |
| getAllAdGroups |
1 |
per item |
| updateAdGroup |
10 |
|
| updateAdGroupList |
10 |
per item |
| AdService |
| addAds |
50 |
per item |
| checkAds |
1 |
per item |
| findBusinesses |
1 |
per item |
| getActiveAds |
1 |
per item |
| getAd |
1 |
|
| getAdStats |
1 |
per item |
| getAllAds |
1 |
per item |
| getMyBusinesses |
1 |
per item |
| getMyVideos |
1 |
per item |
| updateAds |
1 |
per item |
| CampaignService |
| addCampaign |
1 |
|
| addCampaignList |
1 |
per item |
| getAllAdWordsCampaigns |
1 |
per item |
| getCampaign |
1 |
|
| getCampaignList |
1 |
per item |
| getCampaignStats |
1 |
per item |
| getConversionOptimizerEligibility |
1 |
per item |
| getOptimizeAdServing |
1 |
|
| setOptimizeAdServing |
1 |
|
| updateCampaign |
1 |
|
| updateCampaignList |
1 |
per item |
| CriterionService |
| addCriteria |
20 |
per item |
| checkCriteria |
1 |
per item |
| getAllCriteria |
1 |
per item |
| getCampaignNegativeCriteria |
1 |
per item |
| getCriteria |
1 |
per item |
| getCriterionStats |
1 |
per item |
| removeCriteria |
1 |
per item |
| setCampaignNegativeCriteria |
1 |
per item |
| updateCriteria |
3 |
per item |
| InfoService |
| getFreeUsageQuotaThisMonth |
1 |
|
| getMethodCost |
1 |
|
| getOperationCount |
1 |
|
| getOperationsQuotaThisMonth * |
1 |
|
| getUnitCount |
1 |
|
| getUnitCountForClients |
1 |
per item |
| getUnitCountForMethod |
1 |
|
| getUsageQuotaThisMonth |
1 |
|
| KeywordToolService |
| getKeywordsFromSite |
20 |
|
| getKeywordVariations |
20 |
|
| ReportService |
| deleteReport |
1 |
|
| getAllJobs |
1 |
per item |
| getGzipReportDownloadUrl |
1 |
|
| getReportDownloadUrl |
1 |
|
| getReportJobStatus |
1 |
|
| scheduleReportJob |
500 |
|
| validateReportJob |
1 |
|
| SiteSuggestionService |
| getSitesByCategoryName |
1 |
|
| getSitesByDemographics |
1 |
|
| getSitesByTopics |
1 |
|
| getSitesByUrls |
1 |
|
| TrafficEstimatorService |
| checkKeywordTraffic |
1 |
per item |
| estimateAdGroupList |
20 |
per item |
| estimateCampaignList |
20 |
per item |
| estimateKeywordList |
20 |
per item |
API Reference
