VX Agents

OpenAPI Marketplace

Google Ads API

v1.0.0 · 6 endpoints · 0 connections · shared by vx.ai

OpenAPI 3.1 definition for the Google Ads API v25 REST search and customer-scoped resource routes. Calls require OAuth 2.0 plus a developer token.

Connect this API to an AI agent Browse all specs

What you can do with Google Ads API via MCP

Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.

MethodPathOperationDescription
POST /customers/{customerId}/googleAds:search postCustomersByCustomeridGoogleads:search Search Google Ads resources Method: POST Path: /customers/{customerId}/googleAds:search IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)
POST /customers/{customerId}/googleAds:searchStream postCustomersByCustomeridGoogleads:searchstream Stream Google Ads resources Method: POST Path: /customers/{customerId}/googleAds:searchStream IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)
POST /customers/{customerId}/campaigns:mutate postCustomersByCustomeridCampaigns:mutate Mutate campaigns Method: POST Path: /customers/{customerId}/campaigns:mutate IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)
POST /customers/{customerId}/adGroups:mutate postCustomersByCustomeridAdgroups:mutate Mutate ad groups Method: POST Path: /customers/{customerId}/adGroups:mutate IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)
POST /customers/{customerId}/campaignBudgets:mutate postCustomersByCustomeridCampaignbudgets:mutate Mutate campaign budgets Method: POST Path: /customers/{customerId}/campaignBudgets:mutate IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)
POST /customers/{customerId}:generateKeywordHistoricalMetrics postCustomers{customerid}:generatekeywordhistoricalmetrics Generate keyword historical metrics Method: POST Path: /customers/{customerId}:generateKeywordHistoricalMetrics IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - customerId: customerId parameter. Header Parameters: REQUIRED: - developer-token: developer-token parameter. OPTIONAL: - login-customer-id: login-customer-id parameter. Request Body: REQUIRED: - body: Request body (application/json)

Usage guide

## Google Ads API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create OAuth 2.0 credentials and obtain an access token with the Google Ads scope. Send `Authorization: Bearer ACCESS_TOKEN`, the Google Ads developer token in `developer-token`, and `login-customer-id` when operating through a manager account. Use the current v25 REST base URL. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.

How to use this spec

  1. Create a free VX Agents account (sandbox tools included).
  2. Open the marketplace and connect “Google Ads API” to an agent.
  3. Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.