Skip to main content
New to Corsair? See API access, authentication, and error handling.

Ad Groups

create

adGroups.create Create an ad group inside an existing campaign Risk: write
Input
Output

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
Input
Output

Campaign Budgets

create

campaignBudgets.create Create a campaign budget in micros of the account currency Risk: write
Input
Output

update

campaignBudgets.update Change a budget amount or name, which changes how much the campaigns using it can spend Risk: destructive
Input Amounts are micros as strings: 5000000 is 5.00 in the account currency.
Output

Campaigns

create

campaigns.create Create a campaign that starts serving and spending unless status is PAUSED, against an existing budget Risk: destructive
Input Requires a bidding strategy (manualCpc: {} or targetSpend: {}, not both) and containsEuPoliticalAdvertising. Send status: PAUSED to create it without serving.
Output

remove

campaigns.remove Remove a campaign: its status becomes REMOVED and it cannot be restored, only recreated as a new campaign Risk: destructive · Irreversible
Input Sets the status to REMOVED. The row and its metrics stay, but the campaign cannot be restored. Output

update

campaigns.update Change a campaign’s name, status or dates; enabling it starts spending. updateMask names the fields that change Risk: destructive
Input
Output

Customers

listAccessible

customers.listAccessible List the accounts the credentials can call, which is how a caller finds a customer ID Risk: read
Input: empty object Output

update

customers.update Update the account record itself: auto-tagging, final URL suffix and call reporting Risk: write
Input Takes one operation and answers one result. Only the tracking fields are writable. Output

googleAdsFields.search Search the queryable fields, which is how a caller finds what a GAQL statement may select Risk: read
Input Takes no customer path and no FROM clause; it lists the fields any GAQL statement may select. Output

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
Input Each entry names its own entity operation, e.g. { campaignOperation: { remove } }, and the answer is mutateOperationResponses, one per entry, e.g. { campaignResult: { resourceName } }. partialFailure lets the good entries land. Output

search

reporting.search Run a Google Ads Query Language statement and read its rows, 10,000 at a time Risk: read
Input Pages at a fixed 10,000 rows (no 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
Input No paging. The response is an array of chunks, which the plugin flattens into one results list. Output