{
 "categories": [
  "marketing",
  "enterprise"
 ],
 "deployment": "saas",
 "evidence": [
  {
   "date": "2026-09-15",
   "fact": "homepage",
   "note": "Opened Google's Ads API introduction. Google presents the API as the programmatic interface for managing large or complex Google Ads accounts and campaigns.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.exists",
   "note": "Google documents the Google Ads API for automated account management, custom reporting, inventory-based ad management, and Smart Bidding strategy management.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.kinds[0]",
   "note": "Google states the Ads API can be called using gRPC or REST, and that official client libraries except Perl are implemented with gRPC.",
   "source": "https://developers.google.com/google-ads/api/rest/overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.kinds[1]",
   "note": "Google documents a resource-oriented REST interface for callers who do not use a Google-supported client library.",
   "source": "https://developers.google.com/google-ads/api/rest/overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.auth[0]",
   "note": "Google documents OAuth 2.0 as the authentication and authorization protocol for Google Ads API client apps, including multi-user and single-user workflows.",
   "source": "https://developers.google.com/google-ads/api/docs/oauth/overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.auth[1]",
   "note": "Google documents a service-account workflow: create a service account, download its key, add the service-account email as a Google Ads user, and obtain OAuth access tokens without interactive user consent.",
   "source": "https://developers.google.com/google-ads/api/docs/oauth/service-accounts",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.coverage",
   "note": "The API covers account-to-keyword management and reporting. Google also points non-developer or infrastructure-light cases to scripts, BigQuery Data Transfer, automated rules, bulk uploads, and Ads Editor, so coverage is not every Ads UI action.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.api.docs",
   "note": "This page is Google's current Ads API introduction, last updated 2026-09-10 UTC on the opened page.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.exists",
   "note": "Google publishes official Ads API client libraries and recommends them for new users.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.official",
   "note": "The client-library table is vendor-published. Community Node.js and Go libraries are listed separately as unsupported.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[0]",
   "note": "Google lists an official Java client library (google-ads-java) with Maven distribution.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[1]",
   "note": "Google lists an official .NET client library (google-ads-dotnet) on NuGet.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[2]",
   "note": "Google lists an official PHP client library (google-ads-php).",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[3]",
   "note": "Google lists an official Python client library (google-ads-python).",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[4]",
   "note": "Google lists an official Ruby client library (google-ads-ruby).",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.sdk.languages[5]",
   "note": "Google lists an official Perl client library (google-ads-perl) that uses the REST interface.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.mcp.first_party",
   "note": "The googleads/google-ads-mcp README is the vendor-owned MCP server for the Google Ads API, with tools search, get_resource_metadata, and list_accessible_customers.",
   "source": "https://raw.githubusercontent.com/googleads/google-ads-mcp/main/README.md",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.mcp.verdict",
   "note": "The repository is published by the googleads GitHub organization and documents pipx/Cloud Run deployment plus FastMCP OAuth or Application Default Credentials.",
   "source": "https://raw.githubusercontent.com/googleads/google-ads-mcp/main/README.md",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.extensibility.scripting[0]",
   "note": "Google lists Google Ads scripts as the recommended automation product when the caller can write code but does not want to manage their own servers.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "modalities.data_access.export[0]",
   "note": "Google documents GoogleAdsService.SearchStream and Search for fetching entities and performance rows. Client libraries page the Search results.",
   "source": "https://developers.google.com/google-ads/api/docs/client-libs",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "verdict.scores.api",
   "note": "Developer tokens were sunset on 2026-09-09. Access levels now attach to the Google Cloud project. Test-access projects get CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION on v25 production calls. That gate keeps the API path below unusual completeness.",
   "source": "https://developers.google.com/google-ads/api/docs/get-started/dev-token",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "verdict.scores.mcp",
   "note": "The official MCP tools are search, resource metadata, and list_accessible_customers. Mutate is not in the tool list. The server is self-hosted or Cloud Run, not a Google-hosted Ads MCP on the Cloud supported-products table.",
   "source": "https://raw.githubusercontent.com/googleads/google-ads-mcp/main/README.md",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "freshness.watch[0].url",
   "note": "Opened and verified as Google's current Ads API introduction, last updated 2026-09-10 UTC.",
   "source": "https://developers.google.com/google-ads/api/docs/start",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "freshness.watch[1].url",
   "note": "Opened and verified as the current google-ads-mcp README, including tools, ADC/OAuth setup, and Cloud Run notes.",
   "source": "https://raw.githubusercontent.com/googleads/google-ads-mcp/main/README.md",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "freshness.watch[2].url",
   "note": "Opened and verified as the current developer-token sunset and Cloud-project access-level page.",
   "source": "https://developers.google.com/google-ads/api/docs/get-started/dev-token",
   "tier": "declared"
  },
  {
   "date": "2026-09-15",
   "fact": "freshness.watch[3].url",
   "note": "Opened the official MCP Registry search for google ads. The JSON response was servers: [] with count 0. First-party coverage remains the googleads GitHub repository.",
   "source": "https://registry.modelcontextprotocol.io/v0.1/servers?search=google%20ads",
   "tier": "scraped"
  }
 ],
 "freshness": {
  "last_verified": "2026-09-15",
  "volatility": "high",
  "watch": [
   {
    "type": "docs",
    "url": "https://developers.google.com/google-ads/api/docs/start"
   },
   {
    "type": "mcp",
    "url": "https://raw.githubusercontent.com/googleads/google-ads-mcp/main/README.md"
   },
   {
    "type": "docs",
    "url": "https://developers.google.com/google-ads/api/docs/get-started/dev-token"
   },
   {
    "type": "registry",
    "url": "https://registry.modelcontextprotocol.io/v0.1/servers?search=google%20ads"
   }
  ]
 },
 "homepage": "https://developers.google.com/google-ads/api/docs/start",
 "id": "google-ads",
 "license": "commercial",
 "modalities": {
  "agent_docs": {
   "llms_txt": "unknown"
  },
  "api": {
   "auth": [
    "oauth2",
    "service-account"
   ],
   "coverage": "partial",
   "docs": "https://developers.google.com/google-ads/api/docs/start",
   "exists": true,
   "kinds": [
    "grpc",
    "rest"
   ]
  },
  "cli": {
   "exists": "unknown"
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "gaql-searchstream"
   ],
   "import": []
  },
  "extensibility": {
   "scripting": [
    "google-ads-scripts"
   ],
   "webhooks": "unknown"
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. The Google Ads API, official client libraries, and the first-party google-ads-mcp server cover account, campaign, and reporting work without browser control of Ads UI.\n",
   "ui_stack": [
    "web-dom"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "java",
    "dotnet",
    "php",
    "python",
    "ruby",
    "perl"
   ],
   "official": true
  }
 },
 "name": "Google Ads",
 "platforms": [
  "web"
 ],
 "related": {
  "alternatives": [
   "meta-ads"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Google",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 8,
   "cli": null,
   "computer_use": null,
   "integrations": null,
   "mcp": 6,
   "overall": 8,
   "rpa": null
  },
  "summary": "Google Ads is automatable today through the Google Ads API. This record is Google Ads, not Google Analytics, BigQuery, Microsoft Advertising, or Meta Ads. The API is the programmatic interface for managing large or complex accounts from the customer level down to keywords, including automated account management, custom reporting, inventory-based ads, and Smart Bidding. Callers use gRPC or REST. Official client libraries exist for Java, .NET, PHP, Python, Ruby, and Perl; they use gRPC except Perl, which uses REST. Authentication is OAuth 2.0 user credentials or a service account added as a Google Ads user. Developer tokens were sunset on 2026-09-09; access levels now follow the Google Cloud project that owns the OAuth client or service account, and Test-access projects cannot call production accounts. Manager-account access still needs login-customer-id. Google Ads scripts are a vendor-hosted scripting alternative when the caller does not want to run their own servers. The googleads organization publishes a first-party MCP server (search, get_resource_metadata, list_accessible_customers) that wraps the Ads API and can run locally or on Cloud Run. MCP is official but query-oriented, not a mutate surface. Connector catalogs were not opened. Computer-use viability is unassessed. API scores 8 and is the best path because Search, SearchStream, and mutate do not depend on the MCP tool subset.\n"
 }
}