Suggest Google Ads campaigns

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Turns a plain description of a business into two or three complete campaigns you can preview side by side and launch.

Each suggestion carries a payload you can send straight to Create campaign. The approaches differ by goal: Smart Search for traffic, Smart Search for leads, and Performance Max for leads. Nothing is saved.

You get at most three suggestions. suggestion_count accepts up to 5, but only three approaches exist, so 4 and 5 return the same three as 3 does.

The Performance Max suggestion cannot launch as-is: payload.logo_url and payload.images come back empty because this endpoint does not generate images, and Google requires both. Collect them before you send that payload.

Check source before presenting the copy as generated: fallback means the model did not run or returned nothing. title and subtitle are always English, even when the copy inside payload is in the app's language, so translate them yourself if you show them to someone.

This one call runs two language-model requests and debits the shared quota twice.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

{
  "business_name": "Nordwind Furniture",
  "business_description": "Handmade solid oak dining tables, built to order in San Francisco.",
  "landing_page_url": "https://nordwind-furniture.com",
  "campaign_goal": "traffic",
  "daily_budget_micros": 30000000,
  "suggestion_count": 3
}

{
  "suggestions": [
    {
      "campaign_type": "SMART",
      "estimate_source": "heuristic",
      "estimated_daily_clicks": 24,
      "id": "smart-traffic",
      "payload": {
        "business_name": "Nordwind Furniture",
        "campaign_name": "Nordwind Furniture - Traffic",
        "campaign_type": "SMART",
        "daily_budget_micros": 30000000,
        "descriptions": [
          "Solid oak dining tables built to order."
        ],
        "headlines": [
          "Handmade Oak Tables"
        ],
        "images": [],
        "keyword_themes": [
          "handmade oak furniture"
        ],
        "landing_page": "https://nordwind-furniture.com",
        "logo_url": "",
        "settings": {
          "language_code": "en"
        }
      },
      "subtitle": "Best for raising overall visits to the site",
      "title": "Smart Search - drive traffic"
    }
  ],
  "language": "en",
  "source": "ai"
}