AdsAgent — Google Ads MCP

google_ads_quick_create_prepare

Prepare a paused, atomic Search (location_ids and language_ids required), App acquisition, Display responsive, standard Shopping whole-feed, or Demand Gen image graph. Existing media references only; no uploads. App engagement and pre-registration are blocked until authoritative eligibility is available. Demand Gen currently requires USD and explicit image channels. Requires channel-specific flags and full provider validation.

Input Schema

TableJSON Schema

Name	Required	Description
`body`	Yes
`customer_id`	Yes	10-digit Google Ads customer id.
`connection_context`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / body / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "app_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "app_store": {
-        "enum": [
-          "GOOGLE_APP_STORE",
-          "APPLE_APP_STORE"
-        ]
-      },
-      "budget_micros": {
-        "maximum": 9223372036854776000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "campaign_name": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "MULTI_CHANNEL"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "conversion_actions": {
-        "items": {
-          "pattern": "^customers/[0-9]+/conversionActions/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "deep_link": {
-        "pattern": "^https://",
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "maxLength": 90,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 5,
-        "minItems": 1,
-        "type": "array"
-      },
-      "goal": {
-        "enum": [
-          "install_tcpi",
-          "install_volume",
-          "install_action_tcpi",
-          "action_tcpa",
-          "action_volume",
-          "value_roas",
-          "value_volume",
-          "engagement",
-          "pre_registration"
-        ]
-      },
-      "headlines": {
-        "items": {
-          "maxLength": 30,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 5,
-        "minItems": 1,
-        "type": "array"
-      },
-      "image_assets": {
-        "items": {
-          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "pattern": "^[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "pattern": "^[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "target_cpa_micros": {
-        "maximum": 9223372036854776000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "target_roas": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "user_list": {
-        "pattern": "^customers/[0-9]+/userLists/[1-9][0-9]*$",
-        "type": "string"
-      },
-      "video_assets": {
-        "items": {
-          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "app_id",
-      "app_store",
-      "currency_code",
-      "headlines",
-      "descriptions",
-      "contains_eu_political_advertising"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "business_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "DISPLAY"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "final_urls": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "headlines": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "logo_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "long_headline": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "square_marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "business_name",
-      "headlines",
-      "descriptions",
-      "final_urls",
-      "marketing_image_assets",
-      "square_marketing_image_assets",
-      "logo_assets",
-      "long_headline"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "all_products": {
-        "const": true
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "SHOPPING"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "cpc_bid_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "feed_label": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "merchant_id": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "all_products",
-      "cpc_bid_micros",
-      "feed_label",
-      "merchant_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "audience": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "business_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "DEMAND_GEN"
-      },
-      "channels": {
-        "items": {
-          "enum": [
-            "gmail",
-            "discover",
-            "display",
-            "youtubeInFeed"
-          ]
-        },
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "final_urls": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "headlines": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "logo_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "square_marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "business_name",
-      "headlines",
-      "descriptions",
-      "final_urls",
-      "marketing_image_assets",
-      "square_marketing_image_assets",
-      "logo_assets",
-      "channels",
-      "audience"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "anyOf": [
-      {
-        "required": [
-          "campaign_name"
-        ]
-      },
-      {
-        "required": [
-          "name"
-        ]
-      }
-    ],
-    "properties": {
-      "ad_group_cpc_bid_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "ad_group_name": {
-        "maxLength": 255,
-        "minLength": 1,
-        "type": "string"
-      },
-      "ad_group_type": {
-        "type": "string"
-      },
-      "amount_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "campaign_name": {
-        "maxLength": 255,
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "enum": [
-          "SEARCH"
-        ]
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "customer_id": {
-        "pattern": "^[0-9]+$",
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "maxLength": 90,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 4,
-        "minItems": 2,
-        "type": "array"
-      },
-      "final_urls": {
-        "items": {
-          "maxLength": 2048,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 10,
-        "minItems": 1,
-        "type": "array"
-      },
-      "headlines": {
-        "items": {
-          "maxLength": 30,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 15,
-        "minItems": 3,
-        "type": "array"
-      },
-      "keywords": {
-        "items": {
-          "oneOf": [
-            {
-              "maxLength": 80,
-              "minLength": 1,
-              "type": "string"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "match_type": {
-                  "enum": [
-                    "BROAD",
-                    "PHRASE",
-                    "EXACT"
-                  ]
-                },
-                "negative": {
-                  "type": "boolean"
-                },
-                "text": {
-                  "maxLength": 80,
-                  "minLength": 1,
-                  "type": "string"
-                }
-              },
-              "required": [
-                "text"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      },
-      "name": {
-        "maxLength": 255,
-        "minLength": 1,
-        "type": "string"
-      },
-      "roas": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "strategy": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "ad_group_name",
-      "budget_micros",
-      "keywords",
-      "headlines",
-      "descriptions",
-      "final_urls",
-      "contains_eu_political_advertising"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_store": {
+        "enum": [
+          "GOOGLE_APP_STORE",
+          "APPLE_APP_STORE"
+        ]
+      },
+      "budget_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "MULTI_CHANNEL"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "conversion_actions": {
+        "items": {
+          "pattern": "^customers/[0-9]+/conversionActions/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "deep_link": {
+        "pattern": "^https://",
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "maxLength": 90,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "goal": {
+        "enum": [
+          "install_tcpi",
+          "install_volume",
+          "install_action_tcpi",
+          "action_tcpa",
+          "action_volume",
+          "value_roas",
+          "value_volume",
+          "engagement",
+          "pre_registration"
+        ]
+      },
+      "headlines": {
+        "items": {
+          "maxLength": 30,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "image_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "target_cpa_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "target_roas": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "user_list": {
+        "pattern": "^customers/[0-9]+/userLists/[1-9][0-9]*$",
+        "type": "string"
+      },
+      "video_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "app_id",
+      "app_store",
+      "currency_code",
+      "headlines",
+      "descriptions",
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DISPLAY"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "long_headline": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "long_headline"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "all_products": {
+        "const": true
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "SHOPPING"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "cpc_bid_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "feed_label": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "merchant_id": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "all_products",
+      "cpc_bid_micros",
+      "feed_label",
+      "merchant_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "audience": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DEMAND_GEN"
+      },
+      "channels": {
+        "items": {
+          "enum": [
+            "gmail",
+            "discover",
+            "display",
+            "youtubeInFeed"
+          ]
+        },
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "channels",
+      "audience"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "anyOf": [
+      {
+        "required": [
+          "campaign_name"
+        ]
+      },
+      {
+        "required": [
+          "name"
+        ]
+      }
+    ],
+    "properties": {
+      "ad_group_cpc_bid_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "ad_group_name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "ad_group_type": {
+        "type": "string"
+      },
+      "amount_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "enum": [
+          "SEARCH"
+        ]
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "customer_id": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "maxLength": 90,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 4,
+        "minItems": 2,
+        "type": "array"
+      },
+      "excluded_location_ids": {
+        "description": "geo_target_constant ids to exclude.",
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "maxLength": 2048,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      },
+      "geo_target_type": {
+        "description": "Defaults to PRESENCE (only people in the location).",
+        "enum": [
+          "PRESENCE",
+          "PRESENCE_OR_INTEREST"
+        ]
+      },
+      "headlines": {
+        "items": {
+          "maxLength": 30,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 3,
+        "type": "array"
+      },
+      "keywords": {
+        "items": {
+          "oneOf": [
+            {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "match_type": {
+                  "enum": [
+                    "BROAD",
+                    "PHRASE",
+                    "EXACT"
+                  ]
+                },
+                "negative": {
+                  "type": "boolean"
+                },
+                "text": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "text"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      },
+      "language_ids": {
+        "description": "language_constant ids. Required; there is no implicit all-languages default.",
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "description": "geo_target_constant ids (country, region or city) to target. Required; resolve names with google_ads_geo_targets_suggest.",
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "roas": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "strategy": {
+        "type": "string"
+      },
+      "targeting_source": {
+        "description": "Where the targeting came from; shown in the approval summary. Defaults to user.",
+        "enum": [
+          "user",
+          "template",
+          "source_campaign"
+        ]
+      }
+    },
+    "required": [
+      "ad_group_name",
+      "budget_micros",
+      "keywords",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 13, 2026
- addedInput schema / properties / connection_context
```
Added value: +{
+  "pattern": "^mctx_v1_[0-9a-f]{64}$",
+  "type": "string"
+}
```

Changed1 schema field changedOct 8, 2026

changedInput schema / properties / body / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "app_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "app_store": {
-        "enum": [
-          "GOOGLE_APP_STORE",
-          "APPLE_APP_STORE"
-        ]
-      },
-      "budget_micros": {
-        "maximum": 9223372036854776000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "campaign_name": {
-        "maxLength": 128,
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "MULTI_CHANNEL"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "conversion_actions": {
-        "items": {
-          "pattern": "^customers/[0-9]+/conversionActions/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "deep_link": {
-        "pattern": "^https://",
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "maxLength": 90,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 5,
-        "minItems": 1,
-        "type": "array"
-      },
-      "goal": {
-        "enum": [
-          "install_tcpi",
-          "install_volume",
-          "install_action_tcpi",
-          "action_tcpa",
-          "action_volume",
-          "value_roas",
-          "value_volume",
-          "engagement",
-          "pre_registration"
-        ]
-      },
-      "headlines": {
-        "items": {
-          "maxLength": 30,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 5,
-        "minItems": 1,
-        "type": "array"
-      },
-      "image_assets": {
-        "items": {
-          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "pattern": "^[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "pattern": "^[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "target_cpa_micros": {
-        "maximum": 9223372036854776000,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "target_roas": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "user_list": {
-        "pattern": "^customers/[0-9]+/userLists/[1-9][0-9]*$",
-        "type": "string"
-      },
-      "video_assets": {
-        "items": {
-          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "app_id",
-      "app_store",
-      "currency_code",
-      "headlines",
-      "descriptions",
-      "contains_eu_political_advertising"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "business_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "DISPLAY"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "final_urls": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "headlines": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "logo_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "long_headline": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "square_marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "business_name",
-      "headlines",
-      "descriptions",
-      "final_urls",
-      "marketing_image_assets",
-      "square_marketing_image_assets",
-      "logo_assets",
-      "long_headline"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "all_products": {
-        "const": true
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "SHOPPING"
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "cpc_bid_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "feed_label": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "merchant_id": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "all_products",
-      "cpc_bid_micros",
-      "feed_label",
-      "merchant_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ad_group_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "audience": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "budget_micros": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "business_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "campaign_name": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "channel_type": {
-        "const": "DEMAND_GEN"
-      },
-      "channels": {
-        "items": {
-          "enum": [
-            "gmail",
-            "discover",
-            "display",
-            "youtubeInFeed"
-          ]
-        },
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      },
-      "currency_code": {
-        "pattern": "^[A-Z]{3}$",
-        "type": "string"
-      },
-      "customer_id": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "descriptions": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "final_urls": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "headlines": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "language_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "location_ids": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "logo_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "square_marketing_image_assets": {
-        "items": {
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array",
-        "uniqueItems": true
-      }
-    },
-    "required": [
-      "channel_type",
-      "campaign_name",
-      "ad_group_name",
-      "budget_micros",
-      "currency_code",
-      "contains_eu_political_advertising",
-      "business_name",
-      "headlines",
-      "descriptions",
-      "final_urls",
-      "marketing_image_assets",
-      "square_marketing_image_assets",
-      "logo_assets",
-      "channels",
-      "audience"
-    ],
-    "type": "object"
-  },
-  {
-    "not": {
-      "required": [
-        "app_id"
-      ]
-    },
-    "properties": {
-      "channel_type": {
-        "enum": [
-          "SEARCH"
-        ]
-      },
-      "contains_eu_political_advertising": {
-        "enum": [
-          "CONTAINS_EU_POLITICAL_ADVERTISING",
-          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
-        ]
-      }
-    },
-    "required": [
-      "contains_eu_political_advertising"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_store": {
+        "enum": [
+          "GOOGLE_APP_STORE",
+          "APPLE_APP_STORE"
+        ]
+      },
+      "budget_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "MULTI_CHANNEL"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "conversion_actions": {
+        "items": {
+          "pattern": "^customers/[0-9]+/conversionActions/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "deep_link": {
+        "pattern": "^https://",
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "maxLength": 90,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "goal": {
+        "enum": [
+          "install_tcpi",
+          "install_volume",
+          "install_action_tcpi",
+          "action_tcpa",
+          "action_volume",
+          "value_roas",
+          "value_volume",
+          "engagement",
+          "pre_registration"
+        ]
+      },
+      "headlines": {
+        "items": {
+          "maxLength": 30,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "image_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "target_cpa_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "target_roas": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "user_list": {
+        "pattern": "^customers/[0-9]+/userLists/[1-9][0-9]*$",
+        "type": "string"
+      },
+      "video_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "app_id",
+      "app_store",
+      "currency_code",
+      "headlines",
+      "descriptions",
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DISPLAY"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "long_headline": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "long_headline"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "all_products": {
+        "const": true
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "SHOPPING"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "cpc_bid_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "feed_label": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "merchant_id": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "all_products",
+      "cpc_bid_micros",
+      "feed_label",
+      "merchant_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "audience": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DEMAND_GEN"
+      },
+      "channels": {
+        "items": {
+          "enum": [
+            "gmail",
+            "discover",
+            "display",
+            "youtubeInFeed"
+          ]
+        },
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "channels",
+      "audience"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "anyOf": [
+      {
+        "required": [
+          "campaign_name"
+        ]
+      },
+      {
+        "required": [
+          "name"
+        ]
+      }
+    ],
+    "properties": {
+      "ad_group_cpc_bid_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "ad_group_name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "ad_group_type": {
+        "type": "string"
+      },
+      "amount_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "enum": [
+          "SEARCH"
+        ]
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "customer_id": {
+        "pattern": "^[0-9]+$",
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "maxLength": 90,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 4,
+        "minItems": 2,
+        "type": "array"
+      },
+      "final_urls": {
+        "items": {
+          "maxLength": 2048,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      },
+      "headlines": {
+        "items": {
+          "maxLength": 30,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 15,
+        "minItems": 3,
+        "type": "array"
+      },
+      "keywords": {
+        "items": {
+          "oneOf": [
+            {
+              "maxLength": 80,
+              "minLength": 1,
+              "type": "string"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "match_type": {
+                  "enum": [
+                    "BROAD",
+                    "PHRASE",
+                    "EXACT"
+                  ]
+                },
+                "negative": {
+                  "type": "boolean"
+                },
+                "text": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                }
+              },
+              "required": [
+                "text"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      },
+      "name": {
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      },
+      "roas": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "strategy": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "ad_group_name",
+      "budget_micros",
+      "keywords",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedOct 4, 2026

removedInput schema / properties / body / additionalProperties
```
Removed value: -true
```

addedInput schema / properties / body / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "app_store": {
+        "enum": [
+          "GOOGLE_APP_STORE",
+          "APPLE_APP_STORE"
+        ]
+      },
+      "budget_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "maxLength": 128,
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "MULTI_CHANNEL"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "conversion_actions": {
+        "items": {
+          "pattern": "^customers/[0-9]+/conversionActions/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "deep_link": {
+        "pattern": "^https://",
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "maxLength": 90,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "goal": {
+        "enum": [
+          "install_tcpi",
+          "install_volume",
+          "install_action_tcpi",
+          "action_tcpa",
+          "action_volume",
+          "value_roas",
+          "value_volume",
+          "engagement",
+          "pre_registration"
+        ]
+      },
+      "headlines": {
+        "items": {
+          "maxLength": 30,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 5,
+        "minItems": 1,
+        "type": "array"
+      },
+      "image_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "pattern": "^[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "target_cpa_micros": {
+        "maximum": 9223372036854776000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "target_roas": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "user_list": {
+        "pattern": "^customers/[0-9]+/userLists/[1-9][0-9]*$",
+        "type": "string"
+      },
+      "video_assets": {
+        "items": {
+          "pattern": "^customers/[0-9]+/assets/[1-9][0-9]*$",
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "app_id",
+      "app_store",
+      "currency_code",
+      "headlines",
+      "descriptions",
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DISPLAY"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "long_headline": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "long_headline"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "all_products": {
+        "const": true
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "SHOPPING"
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "cpc_bid_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "feed_label": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "merchant_id": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "all_products",
+      "cpc_bid_micros",
+      "feed_label",
+      "merchant_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ad_group_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "audience": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "budget_micros": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "business_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "campaign_name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "channel_type": {
+        "const": "DEMAND_GEN"
+      },
+      "channels": {
+        "items": {
+          "enum": [
+            "gmail",
+            "discover",
+            "display",
+            "youtubeInFeed"
+          ]
+        },
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      },
+      "currency_code": {
+        "pattern": "^[A-Z]{3}$",
+        "type": "string"
+      },
+      "customer_id": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "descriptions": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "final_urls": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "headlines": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "language_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "location_ids": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "logo_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "square_marketing_image_assets": {
+        "items": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array",
+        "uniqueItems": true
+      }
+    },
+    "required": [
+      "channel_type",
+      "campaign_name",
+      "ad_group_name",
+      "budget_micros",
+      "currency_code",
+      "contains_eu_political_advertising",
+      "business_name",
+      "headlines",
+      "descriptions",
+      "final_urls",
+      "marketing_image_assets",
+      "square_marketing_image_assets",
+      "logo_assets",
+      "channels",
+      "audience"
+    ],
+    "type": "object"
+  },
+  {
+    "not": {
+      "required": [
+        "app_id"
+      ]
+    },
+    "properties": {
+      "channel_type": {
+        "enum": [
+          "SEARCH"
+        ]
+      },
+      "contains_eu_political_advertising": {
+        "enum": [
+          "CONTAINS_EU_POLITICAL_ADVERTISING",
+          "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
+        ]
+      }
+    },
+    "required": [
+      "contains_eu_political_advertising"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties / body / type
```
Removed value: -"object"
```

First observedSep 16, 2026

TDQS

A3.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With annotations only giving safety hints (readOnlyHint=false, destructiveHint=false, openWorldHint=false), the description carries the real burden and delivers: campaigns are created PAUSED and atomic, media must pre-exist (no uploads), App engagement/pre-registration are blocked pending eligibility, Demand Gen is USD-only with explicit image channels, and full provider validation is required. It stops short of describing what the prepare step returns or the confirm handoff.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Five terse sentences, behavior and constraints front-loaded, no filler. The opening sentence is heavily clause-stacked, but for a tool spanning five distinct campaign graphs the density is largely earned.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a highly complex tool (five oneOf variants, no output schema, no nested-param docs), the description covers the constraints an agent most needs to avoid failure: paused/atomic creation, no uploads, eligibility gating, currency and channel rules. It would be stronger if it stated the prepare→confirm relationship and clarified output, but it is close to sufficient.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% and many parameters live in nested oneOf branches, so the description must compensate. It does flag location_ids/language_ids as required for Search and currency/channel constraints for Demand Gen, but it leaves most fields (app_id, goals, keywords, feed_label, merchant_id, etc.) with no added meaning. Partial compensation, so a middle score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Prepare') and enumerates exactly which campaign graphs it covers (Search, App acquisition, Display responsive, Shopping whole-feed, Demand Gen), which is far more precise than the bare name. It does not, however, distinguish itself from the many sibling create tools (campaign_create_prepare, pmax_create_prepare, responsive_search_ad_create_prepare) that an agent could plausibly confuse it with.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: the prepare/confirm pairing (google_ads_quick_create_confirm exists) is never named, nor is the wizard-style flow into confirm. It does carve out scope behaviorally ('existing media references only; no uploads'), which helps route away from asset_upload_prepare, but gives no explicit when-to-use/when-not guidance or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AdsAgent — Google Ads MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?