AdMob API Skill for AI Agents

A comprehensive, zero-error AI Agent Skill for integrating and managing the Google AdMob REST API (v1 & v1beta).

This skill arms AI agents (like Claude, Antigravity, ChatGPT, Custom LLM Agents) with exact API resource names, request/response JSON schemas, strict metric-dimension compatibility guardrails, and automated reporting workflows.

---

📁 Repository Structure

admob-api-skill/
├── SKILL.md                 # Main agent instructions, 19-API matrix, & zero-error guardrails
├── references/
│   ├── endpoints.md         # Full REST schemas, paths, HTTP methods, & OAuth scopes
│   └── reporting.md         # Network, Mediation, & Campaign reporting metrics/dimensions
├── LICENSE                  # MIT License
└── README.md                # Repository overview & installation guide

---

⚡ What's Included

1. Complete 19-Method API Coverage

• Accounts: accounts.get, accounts.list
• Apps: accounts.apps.create, accounts.apps.list
• Ad Units & Mappings: accounts.adUnits.create, accounts.adUnits.list, accounts.adUnits.adUnitMappings.create, accounts.adUnits.adUnitMappings.list, accounts.adUnitMappings.batchCreate
• Mediation & A/B Experiments: accounts.adSources.list, accounts.adSources.adapters.list, accounts.mediationGroups.create, accounts.mediationGroups.list, accounts.mediationGroups.patch, accounts.mediationGroups.mediationAbExperiments.create, accounts.mediationGroups.mediationAbExperiments.stop
• Reporting: accounts.networkReport.generate, accounts.mediationReport.generate, accounts.campaignReport.generate

2. Zero-Error Guardrails for AI Agents

• Strict Metric-Dimension Incompatibility: Prevents illegal parameter combinations (e.g. AD_TYPE with AD_REQUESTS or IMPRESSION_RPM).
• Date Range Ceilings: Enforces 30-day max range limit on Campaign Reports.
• Batch Size Limits: Enforces 100-item ceiling on batchCreate mappings.
• Micros Currency Conversion: Handles revenue & eCPM figures in micros ($1.00 USD = 1000000 micros).

---

🚀 Installation & Agent Usage

Option 1: Install via skills.sh CLI (Recommended)

You can easily install this skill into your environment using npx skills:

npx skills add w3wide/admob-api-skill

Or clone/copy directly using git:

git clone https://github.com/w3wide/admob-api-skill.git ~/.gemini/skills/admob-api-skill

Option 2: Direct Prompt Usage

Simply point your agent to SKILL.md when building Google AdMob integrations:

"Use the instructions in SKILL.md to generate a Python script that fetches my AdMob Network report for July 2026."

---

📜 License

Distributed under the MIT License. See LICENSE for details.