Discover connected Google Ads accounts. Every other googleads call takes one of these sourceIds. Exact parameter shapes remain runtime truth.

Customer accounts directly accessible to the connection's OAuth user. The connected source itself is bound to exactly one of them.

The load-bearing account facts: currency, time zone, manager and test flags, status. Read this first: every money value in reports is micros of THIS currency, and every date is account-local in THIS time zone.

Entity listings (campaigns, ad groups, ads, criteria, budgets, labels) without metrics: no date range, no segmentation.

Bounded metrics report: mandatory account-local dateRange, explicitly declared segments, explicit limit. The result reports segmentationApplied; carry it next to the numbers. Selectable fields, metrics, and segments are catalog-driven per FROM resource; an invalid one refuses locally with the exact reason instead of spending a failing provider call.

Change history over a mandatory window. Google retains change events for roughly 14 to 30 days only. The email of the person who made a change is not exposed.

Keyword Planner historical metrics for up to 200 keyword texts per call: average monthly searches, competition and top-of-page bid range, for an allowlisted set of countries and one language. This is Google's market data, not this account's performance, and volumes are summed over the countries asked for, so ask one country at a time to compare them. Insights access level; keyword planning needs Google Ads API Basic access or higher (see Access level below).

Conversion actions with their category, origin, primary goal flag, value, attribution and tracking snippets. Bounded listing; a full page may mean more actions exist. Insights access level.

One campaign's conversion goals, keyed by category and origin, plus its standard or custom goal configuration. Returns the exact goal resource names setCampaignConversionGoals takes. Insights access level.

Pause or resume campaigns. Only ENABLED and PAUSED exist on this verb; permanent removal is the separate removeCampaign at the Management level. Resuming always needs a human approval; pausing follows the organization's setting.

Pause or resume ad groups. Resuming always needs a human approval; pausing follows the organization's setting.

Pause or resume ads. Resuming an ad (status ENABLED) makes it serve, so it always needs a human approval, whatever the organization's approval setting says; pausing follows the setting. Ads created PAUSED follow the setting for their class; creating an ad ENABLED always needs a human.

Pause or resume keywords. Resuming always needs a human approval; pausing follows the organization's setting.

Add negative keywords at campaign or ad-group level.

Remove negative keywords. A mandatory same-snapshot pre-read proves each criterion is actually negative before the mutation composes, so a positive keyword can never be touched through this path.

Create a label definition. Stays inside the account's own records.

Attach labels to campaigns, ad groups, ads, or keywords.

Detach label assignments: the assignment, never the labelled entity.

Rename campaigns. Management access level. Names are 1 to 255 characters without control characters; a new name is a value, never an address.

Rename ad groups. Management access level. Same name rules as renameCampaign.

Set a campaign budget's daily amount in micros of the account currency. Management access level, high consequence class, human approval by default. A mandatory same-snapshot pre-read proves the budget exists; pass expectedAmountMicros (the amount you last read) and the write refuses if the live amount moved in between. Shared budgets are named with their campaign count on the approval page.

Set a keyword's ad-group-level CPC bid in micros of the account currency. Management access level, high consequence class, human approval by default. A mandatory same-snapshot pre-read proves each criterion is a positive KEYWORD (a Shopping listing group or a negative keyword is refused); pass expectedCpcBidMicros (the bid you last read) and the write refuses if the live bid moved in between.

googleads.updateUrlOptions.v1 updates campaign or ad group tracking_url_template and final_url_suffix with a selective field mask so only supplied fields change. It is consequence class high and supports validateOnly, with one human confirmation per operation including validation. Tracking templates support the landing-page macros {lpurl}, {unescapedlpurl}, {escapedlpurl}, {lpurl+2}, and {lpurl+3}.

Turn account auto-tagging on or off; pass expectedEnabled from your read and a live preflight refuses a setting that changed. Management access level, high consequence class, human approval by default. Turning it off loses click-tagging data until it is turned on again.

Create one Search campaign with its daily budget (an existing budget or a new one created in the same atomic call) and bidding strategy. Management access level, high consequence class, human approval by default. The campaign starts PAUSED unless status ENABLED is passed; exact parameter shapes remain runtime truth.

Add location and language targets to a campaign; without location targets a campaign serves everywhere. Management access level, high consequence class, human approval by default: targeting decides where money is spent, and spend already caused does not revert.

Create Search ad groups in a campaign, without bids. Management access level, medium consequence class: an empty ad group spends nothing, so it runs without approval unless the organization's setting asks for one. Ad groups start PAUSED unless status ENABLED is passed.

Add positive keywords (text and match type) to an ad group; negative keywords go through addNegativeKeywords. Management access level, high consequence class, human approval by default. Keywords start PAUSED unless status ENABLED is passed.

Create one responsive search ad (headlines, descriptions, final URLs, optional display paths) in an ad group. Management access level, high consequence class. A paused ad, the default, follows the organization's setting for its class; an ad created ENABLED always needs a human approval, and so does enabling it later with setAdStatus.

Create sitelink, callout and structured snippet assets. Management access level, low consequence class: an unlinked asset serves nothing, so it runs without approval unless the organization's setting asks for one. An asset serves only after linkAssets links it.

Link existing assets to one campaign or one ad group. Management access level, high consequence class, human approval by default: a link decides what serves beside the ad. Links default to ENABLED; serving still depends on the campaign and ad group status.

Remove asset links from campaigns or ad groups: the link only, never the asset and never the campaign or ad group. Management access level, medium consequence class, so it runs without approval unless the organization's setting asks for one; one linkAssets call undoes it.

Create one primary WEBPAGE conversion action; its status is required (ENABLED or HIDDEN). Management access level, high consequence class, and a human always approves, whatever the organization's setting says: it changes what the account measures and bids toward. Creating the action does not install the Google tag or event snippet on the website.

Switch one campaign to standard conversion goals, clear its custom goal, and set biddable per category and origin in one atomic call; goals left out keep their settings, so set unwanted goals to false explicitly. Management access level, high consequence class, and a human always approves, whatever the organization's setting says.

Permanently remove campaigns after a live name and status preflight; every target names the exact campaign name last read. Management access level, critical consequence class, and a human always approves, including validateOnly. A removed campaign cannot be restored or resumed; to stop one reversibly, pause it with setCampaignStatus.