Google Ads API Integration · Basic Access Applicant

Human-supervised Google Ads management

AdOps Agent is an internal management tool built and operated by Academy.Partners to assist a human operator in managing Google Ads client accounts under our manager account (MCC).

Operated by Academy.Partners Manager account 115-798-0509 Region Argentina

Who is Academy.Partners

Academy.Partners is a corporate training company based in Argentina, offering certification programs and tailored learning paths for organizations. Alongside our main line of business, we provide performance-marketing services to a small portfolio of advertiser accounts linked to our Google Ads manager account (MCC 115-798-0509).

To manage these accounts with consistency, traceability, and safety, we developed an internal tool called AdOps Agent. This site describes that tool and the way it integrates with the Google Ads API.

What AdOps Agent does

AdOps Agent works as an analyst that continuously monitors the Google Ads accounts we manage, identifies optimization opportunities, and proposes concrete changes for a human operator to review.

1

Performance reads

Periodically syncs account structure and metrics (campaigns, ad groups, keywords, impressions, clicks, conversions, spend) through the official Google Ads API.

2

Anomaly detection

A statistical engine flags significant deviations: unexpected spend spikes, conversion rate drops, cost-per-lead deterioration.

3

Documented reasoning

For each significant anomaly, the tool generates a written diagnosis, a proposed action, quantitative evidence, a confidence score, and a risk level.

4

Human approval required

No proposal reaches Google Ads without an operator explicitly approving it. There is no autonomous execution.

5

Bounded, reversible actions

Only three actions are permitted: reduce a campaign budget, pause an underperforming keyword, add a negative keyword. Every change is reversible.

6

Configurable constraints

Per-account rules bound the space of allowed proposals: max budget change, min confidence, max risk level, disallowed action types.

How a decision reaches Google Ads

Every optimization goes through the same lifecycle. The human operator is the gate: no change is ever executed automatically.

STEP 1
Read
Sync account structure and metrics via Google Ads API.
STEP 2
Analyze
Detect statistical anomalies and reason about their causes.
STEP 3
Propose
Generate a bounded proposal with diagnosis, evidence, and risk.
STEP 4
Approve
A human operator reviews and explicitly approves or rejects.
STEP 5
Execute
Only approved proposals are sent to Google Ads via mutate services.
STEP 6
Reversible
Every executed change stores a rollback payload and can be undone.
Human-in-the-loop by design. The tool operates on managed advertiser accounts under our MCC, with full audit trail of every proposal, approval, execution, and outcome evaluation.

API usage

AdOps Agent uses the official Google Ads API client library. Access is scoped to the specific mutations required by the tool's whitelist.

Read operations

  • GoogleAdsService.SearchStream — campaign, ad group, and keyword structure.
  • Metrics — impressions, clicks, cost, conversions, conversion value.
  • Scheduling — three times daily by default, per managed account.

Write operations

  • CampaignBudgetService.mutate — reduce budget only, bounded by percentage.
  • AdGroupCriterionService.mutate — pause a keyword, or add negative keyword.
  • Triggered only after explicit human operator approval.

Safeguards and compliance

The tool is designed with multiple layers of safety to comply with Google Ads API policy and to protect the accounts we manage.

Action whitelist
Only three specific actions are permitted by design. Any other action is impossible.
Confidence and risk thresholds
Proposals below the confidence threshold or above the risk threshold are automatically rejected.
Bounded magnitudes
Budget changes are capped by percentage per action; large swings are impossible.
Full audit trail
Every proposal, approval, execution, and outcome is logged with timestamp and actor.
Rollback for every change
Previous state is stored on execution; any executed change can be reverted with one action.
Multi-tenant isolation
Data of one managed account is never visible to another; all access is row-scoped per tenant.
Secrets outside version control
OAuth credentials and refresh tokens are stored in environment files, never committed to the code repository.
Dry-run capability
The system can operate end-to-end without executing writes, used for validation and staged rollout.

Academy.Partners

Academy.Partners is a corporate training company operating in Argentina and the broader LATAM region. In addition to our corporate learning services, we provide performance-marketing services to a portfolio of client accounts under our Google Ads manager account.

AdOps Agent is an internal tool operated by Academy.Partners under a single accountable operator. It is not offered as a public product; it is a proprietary internal system used to manage the campaigns of our client accounts.

Company
Academy.Partners
Country
Argentina
Website
academy.partners
Google Ads MCC
115-798-0509
Operator
Mariano Angelino

Get in touch

For questions about AdOps Agent or the Google Ads API integration.