← Back to Skills Marketplace
6911
Downloads
20
Stars
9
Active Installs
8
Versions
Install in OpenClaw
/install google-ads-api
Description
Google Ads API integration with managed OAuth. Query campaigns, ad groups, keywords, and performance metrics with GAQL. Use this skill when users want to int...
Usage Guidance
Install only if you trust Maton to proxy Google Ads requests and handle OAuth for the connected account. Connect only the intended Google Ads account, specify the connection when multiple accounts exist, and review any proposed create, update, or delete action before approving it.
Capability Analysis
Type: OpenClaw Skill
Name: google-ads-api
Version: 1.0.7
The skill bundle provides documentation and code examples for integrating with the Google Ads API via the Maton API proxy (api.maton.ai). It includes standard CLI, Python, and JavaScript snippets for querying campaign data and managing OAuth connections, and it explicitly instructs the agent to seek user approval for write operations. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
The stated purpose matches the artifact: it provides Google Ads query examples, GAQL references, account/customer lookup, and connection management. The capability involves sensitive advertising and business data, so users should treat access as privileged.
Instruction Scope
The skill includes raw API proxy examples and a connection deletion command, but this is within the documented Google Ads/Maton connection-management workflow and the artifact explicitly says create, update, and delete calls require user approval.
Install Mechanism
The bundle itself is documentation-only with no executable scripts, but it recommends installing the external Maton CLI globally through npm or Homebrew, which adds trust in that external distribution channel.
Credentials
Network access and MATON_API_KEY are clearly disclosed and proportionate for a managed OAuth Google Ads integration. The artifact also discloses that Maton proxies requests to Google Ads and injects OAuth/developer tokens.
Persistence & Privilege
The skill manages persistent OAuth connections through Maton and includes list, create, view, select, and delete operations. This persistence is expected for the purpose, but users should verify connection IDs and account scope before approving changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-ads-api - After installation, invoke the skill by name or use
/google-ads-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
Version 1.0.7 - Update: CLI and API usage improvements, v24 upgrade
- Updated examples and documentation to use Google Ads API v24 (was v23).
- Enhanced quick start with CLI (`maton`) command examples for common queries.
- Added installation and authentication instructions for the Maton CLI (with NPM and Homebrew).
- Expanded code snippets for CLI, Python, and API workflows.
- Clarified connection handling and how to specify connections in CLI and API calls.
v1.0.6
- Updated all endpoints from gateway.maton.ai and ctrl.maton.ai to new unified domain api.maton.ai.
- Clarified that Maton proxies to Google, handles credentials, and write operations require explicit user approval.
- Added a Security & Permissions section.
- Minor text and code example refinements for improved clarity and consistency.
- Removed LICENSE.txt file.
v1.0.5
- Added Clawdbot metadata to SKILL.md, including required environment variable details.
- No functional or documentation changes to the skill's usage or interface.
v1.0.4
- Minor update to troubleshooting section for API key errors; now more concise and clearly titled "Troubleshooting: API Key Issues"
- No functional or feature changes detected
- Documentation and usage instructions remain unchanged
v1.0.3
- Quick start and all connection management examples now use Python one-liners instead of curl.
- Added a "Troubleshooting: Invalid API Key" section with explicit steps for diagnosing API key errors.
- No changes to the API itself or to existing code snippets for JavaScript and Python functions.
v1.0.2
- Added a note in the description recommending the use of the api-gateway skill for third party apps other than Google Ads.
- Updated shell command examples to use environment variable syntax ($MATON_API_KEY).
- Added important tips for using curl (-g for bracketed URLs, environment variable handling when piping).
- Minor formatting and clarity improvements throughout the documentation.
v1.0.1
- Updated the base URL format to support direct mapping of native Google Ads API paths.
- Added instructions for specifying which connection to use via the Maton-Connection header when managing multiple Google Ads connections.
- Expanded example OAuth connection response to include metadata, creation_time, and last_updated_time fields.
- Clarified that creating a Maton account is required to obtain an API key.
v1.0.0
- Major update: Transitioned to managed OAuth and API gateway for Google Ads.
- Browser automation and Python SDK modes removed; now uses direct HTTP endpoints via Maton gateway.
- Added instructions for API key-based authentication and Google Ads OAuth connection management.
- Provided API reference for listing customers, running GAQL queries, and handling large result sets.
- Included GAQL query samples and ready-to-use code examples for JavaScript and Python.
- Streamlined troubleshooting, removed browser-specific details, and enhanced documentation links.
- LICENSE.txt added; old reference markdown files removed.
Metadata
Frequently Asked Questions
What is Google Ads?
Google Ads API integration with managed OAuth. Query campaigns, ad groups, keywords, and performance metrics with GAQL. Use this skill when users want to int... It is an AI Agent Skill for Claude Code / OpenClaw, with 6911 downloads so far.
How do I install Google Ads?
Run "/install google-ads-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Ads free?
Yes, Google Ads is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Google Ads support?
Google Ads is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Ads?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.0.7.
More Skills