SynthBid
Google Ads API

How we use the API.

SynthBid integrates directly with the Google Ads API to operate the Search campaigns in advertiser accounts we own. This page describes exactly what the tool reads and writes, and the controls around it — so a reviewer can understand the full surface of our usage.

01 · Creation

Build campaigns

Stage new Search campaigns end to end:

  • Campaigns & campaign budgets
  • Ad groups
  • Keywords (exact / phrase / broad)
  • Responsive search ads
02 · Management

Maintain accounts

Keep live campaigns healthy:

  • Adjust CPC bids
  • Add negative keywords
  • Pause / enable keywords & campaigns
  • Update ad-group structure
03 · Reporting

Read performance

Pull data to inform decisions:

  • Search-term reports
  • Keyword & campaign metrics
  • Impression-share signals
  • Responsive-ad strength & status
Detail

What the tool actually calls.

Reporting readsGoogleAdsService.SearchStream
All reporting runs through GAQL queries against resources such as search_term_view, keyword_view, campaign and ad_group_ad. We read metrics (cost, clicks, impressions, conversions, impression share) to decide what to add, pause or re-bid. Reads never modify the account.
Campaign creationCampaign / AdGroup / AdGroupAd services
When an operator approves a draft, the tool creates the campaign, its budget, ad groups, keywords and responsive search ads. Drafts are assembled and shown for review first; the create calls only fire after explicit approval.
Bid & status changesmutate + FieldMask
Bid updates and pause/enable actions use targeted mutate operations with a field mask, so only the intended field changes. Every mutate is generated from a reviewed queue item, never from an unattended loop.
Negative keywordsCampaignCriterion / AdGroupCriterion
Operators add negative keywords at campaign or ad-group level to cut wasted spend. The tool de-duplicates against existing criteria before writing, so approved changes stay clean and idempotent.
Account scopeManager + linked client accounts
SynthBid operates only on Google Ads accounts that we own and that are linked under our own manager account. We do not access, manage or onboard accounts belonging to outside advertisers or clients.
Controls

The guardrails around every write.

Human checkpoint

Review before apply

No create, update or remove reaches a live account without an operator approving that specific item in the review queue.

Least privilege

Scoped access

The tool authenticates through OAuth with a single developer token and operates strictly within our own linked accounts.

Auditable

Every change logged

Each applied operation is recorded — what changed, on which account, approved by whom — so actions can be traced and reversed.

SynthBid is an internal tool. It is operated only by our authorized staff on our own advertiser accounts, and is not offered, resold or exposed to third-party advertisers. Questions about our API usage can be sent to the contact on our contact page.