Ad Groups
create
adGroups.create
Create an ad group inside an existing campaign
Risk: write
adGroup full type
adGroup full type
results full type
results full type
partialFailureError full type
partialFailureError full type
update
adGroups.update
Change an ad group’s name, status or default CPC bid, which can change spend; updateMask names the fields that change
Risk: destructive
adGroup full type
adGroup full type
results full type
results full type
partialFailureError full type
partialFailureError full type
Campaign Budgets
create
campaignBudgets.create
Create a campaign budget in micros of the account currency
Risk: write
campaignBudget full type
campaignBudget full type
results full type
results full type
partialFailureError full type
partialFailureError full type
update
campaignBudgets.update
Change a budget amount or name, which changes how much the campaigns using it can spend
Risk: destructive
5000000 is 5.00 in the account currency.
campaignBudget full type
campaignBudget full type
results full type
results full type
partialFailureError full type
partialFailureError full type
Campaigns
create
campaigns.create
Create a campaign that starts serving and spending unless status is PAUSED, against an existing budget
Risk: destructive
manualCpc: {} or targetSpend: {}, not both) and containsEuPoliticalAdvertising. Send status: PAUSED to create it without serving.
campaign full type
campaign full type
results full type
results full type
partialFailureError full type
partialFailureError full type
remove
campaigns.remove
Remove a campaign: its status becomes REMOVED and it cannot be restored, only recreated as a new campaign
Risk: destructive · Irreversible
results full type
results full type
partialFailureError full type
partialFailureError full type
update
campaigns.update
Change a campaign’s name, status or dates; enabling it starts spending. updateMask names the fields that change
Risk: destructive
campaign full type
campaign full type
results full type
results full type
partialFailureError full type
partialFailureError full type
Customers
listAccessible
customers.listAccessible
List the accounts the credentials can call, which is how a caller finds a customer ID
Risk: read
update
customers.update
Update the account record itself: auto-tagging, final URL suffix and call reporting
Risk: write
result. Only the tracking fields are writable.
Output
result full type
result full type
Google Ads Fields
search
googleAdsFields.search
Search the queryable fields, which is how a caller finds what a GAQL statement may select
Risk: read
results full type
results full type
Reporting
mutate
reporting.mutate
Mutate any entity in one call: each entry names its own operation, and removing is permanent for that entity
Risk: destructive
{ campaignOperation: { remove } }, and the answer is mutateOperationResponses, one per entry, e.g. { campaignResult: { resourceName } }. partialFailure lets the good entries land.
Output
mutateOperationResponses full type
mutateOperationResponses full type
partialFailureError full type
partialFailureError full type
search
reporting.search
Run a Google Ads Query Language statement and read its rows, 10,000 at a time
Risk: read
pageSize); pass nextPageToken back as pageToken.
Output
searchStream
reporting.searchStream
Run a query and read the whole result set in one response, without paging
Risk: read
results list.
Output