# google-ads-scripts

A reference for writing and debugging Google Ads Scripts in JavaScript, from GAQL queries to Sheets workflows. Use it to automate account tasks and reporting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 111
- Author: Cogny AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/google-ads-scripts/SKILL.md
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/skills/google-ads-scripts

## What it does

This skill covers the `AdsApp` object model, selectors and iterators, GAQL queries, and common script patterns. Ask it to draft or debug code for tasks such as monitoring budgets, finding negative keywords, or logging metrics in Google Sheets.

Scripts run inside the Google Ads interface. They need no external server, API keys, or OAuth, and use JavaScript on the V8 runtime. Examples include error handling and a `DRY_RUN` flag for account changes. Execution is limited to 30 minutes for a single account and 60 minutes for MCC. npm packages and `import`/`export` are unsupported, so code that depends on them will not run in this environment.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/google-ads-scripts/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/google-ads-scripts/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/google-ads-scripts/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/google-ads-scripts/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cognyai/claude-code-marketing-skills google-ads-scripts
```

2. **Manually: put the files in place**
- File: `.github/skills/google-ads-scripts/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/google-ads-scripts
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/google-ads-scripts/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill google-ads-scripts -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/google-ads-scripts/SKILL.md

## When to use it
- write a script to monitor budget pacing
- find search terms to add as negative keywords
- log account metrics to Google Sheets
- build a GAQL query for a report
- process multiple accounts through MCC

## Example prompts
- Write a Google Ads script to monitor budget pacing.
- Find search terms that I could add as negative keywords.
- Show me how to log Quality Score in Google Sheets.

## Similar
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 238500 installs
- [programmatic-seo](https://affpapa.org/en/nevibecode/skills/coreyhaines31-programmatic-seo.md) — skill · 150800 installs
- [copy-editing](https://affpapa.org/en/nevibecode/skills/coreyhaines31-copy-editing.md) — skill · 149800 installs
- [marketing-ideas](https://affpapa.org/en/nevibecode/skills/coreyhaines31-marketing-ideas.md) — skill · 147400 installs
- [sales-enablement](https://affpapa.org/en/nevibecode/skills/sales-enablement.md) — skill · 119400 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 114000 installs

From the same set: [cognyai/claude-code-marketing-skills](https://affpapa.org/en/nevibecode/by/cognyai/claude-code-marketing-skills.md) — 38 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md