{
 "schema": "aiblocks-page/1",
 "id": "google-ads-operator-agent-builder-prompt",
 "type": "prompt",
 "name": "Google Ads agent development planner",
 "summary": "Get a coding brief that plans a read-only Google Ads agent for your project, with a module map, safety rules and tests. No account changes.",
 "headline": "Google Ads agent development planner",
 "subhead": "Give your coding assistant your project, your Google Ads read access and where results should go. It plans a Google Ads agent that checks your account on a schedule and posts recommendations. You get a module map, safety rules, a build order and a test plan. The agent never changes your account.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "codebase",
   "required": true,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  }
 ],
 "outputs": [
  {
   "type": "code_change",
   "required": true,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  }
 ],
 "you_give": [
  "Your code project, or its main folders, language, database and job queue",
  "Your Google Ads access details by name, such as the manager account, the customer IDs the agent may read and where credentials are kept (never the secrets)",
  "Where results should go, such as a database table, a chat channel or a report file",
  "The areas to cover first (optional)",
  "Any limit on API calls, AI calls or run time (optional)"
 ],
 "you_get": [
  "A list of setup gaps before any code is written",
  "A module map that fits your project",
  "One shared result shape for every module",
  "A data flow and a written safety boundary",
  "A build order, a first small version and a test plan"
 ],
 "use_when": [
  "You want one agent that watches Google Ads and posts what to fix, and you have no design for it yet.",
  "You have a few Google Ads scripts and need a plan to turn them into one system.",
  "A developer or an AI assistant is about to build Google Ads modules and needs one agreed shape first.",
  "You need a written safety rule that the agent can read data but never change the account."
 ],
 "skip_when": [
  "You want to build only one area, such as Display placements or Performance Max. Use that area's own coding prompt, for example the Display ad audit tool planner.",
  "You want a one-time review of an account, not code. Paste an export into the Google Ads report auditor.",
  "You want an agent that changes bids, budgets or campaigns for you. This plan is recommendation only and does not build write mode.",
  "You have no Google Ads API access yet. Start with the Google Ads OAuth setup planner, then the Google Ads developer access checker."
 ],
 "output_sample": {
  "input": [
   "Your code project, or its main folders, language, database and job queue",
   "Your Google Ads access details by name, never the secrets",
   "Where results should go, such as a table, a chat channel or a report file",
   "The areas to cover first (optional)"
  ],
  "prerequisites": [
   "Google Ads API access with read permission, set up before you run the agent",
   "A coding assistant that can open your project, such as Claude Code or Codex"
  ],
  "output": [
   {
    "name": "Setup gaps",
    "contains": "Missing schemas, permissions, queue and places to post, each with what it stops."
   },
   {
    "name": "Module map",
    "contains": "Each module, what it does and where it sits in your project."
   },
   {
    "name": "Shared types",
    "contains": "The fields every finding and run result has, so modules can be combined."
   },
   {
    "name": "Data flow",
    "contains": "How a scheduled job moves from the API through the checks to a saved run and a post."
   },
   {
    "name": "Safety boundary",
    "contains": "What the agent may and may not do, and the gates any future write mode would need."
   },
   {
    "name": "Build order",
    "contains": "The order to build the modules and the prompt to use for each one."
   },
   {
    "name": "Test plan",
    "contains": "A test for each module on made-up data, and an optional read of one known account."
   },
   {
    "name": "Open questions",
    "contains": "Questions you still need to answer before the first module is built."
   }
  ]
 },
 "output_shape": "SETUP GAPS\n<what is missing: schemas, permissions, queue, places to post>\n\nMODULE MAP\n<module> | <what it does> | <file in your project>\n\nSHARED TYPES\n<finding and run result fields>\n\nDATA FLOW\n<schedule, handler, fetcher, modules, saved run, post>\n\nSAFETY BOUNDARY\n<in scope, out of scope, gates for any write mode>\n\nBUILD ORDER\n<step> | <module> | <prompt to use next>\n\nTEST PLAN\n<module> | <test on made-up data> | <smoke test, optional>\n\nOPEN QUESTIONS\n<questions for the owner>",
 "how_to_use": [
  "Open your coding assistant, such as Claude Code or Codex, in your project folder. A plain chat AI can only write a plan.",
  "Paste the skill, then add your project details and where results should go. Never paste a secret key.",
  "Read the setup gaps first. Fix each one, or tell the assistant to go on with placeholders.",
  "Read the safety boundary. Check that it says the agent never writes to your account.",
  "Pick the first small version from the build order. Use the matching prompt from the list in the skill for each module.",
  "Run the tests on made-up data before you point anything at a live account."
 ],
 "checks": [],
 "next": [
  {
   "name": "Simple code coach",
   "url": "https://useaiblocks.com/skills/simple-code-coach",
   "why": "Build it"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/worked-example.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/prompts/google-ads-operator-agent-builder-prompt",
  "markdown": "https://useaiblocks.com/prompts/google-ads-operator-agent-builder-prompt.md",
  "json": "https://useaiblocks.com/prompts/google-ads-operator-agent-builder-prompt.json",
  "instructions": "https://useaiblocks.com/skills/google-ads-operator-agent-builder-prompt/SKILL.md",
  "download": "https://useaiblocks.com/skills/google-ads-operator-agent-builder-prompt.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/google-ads-operator-agent-builder-prompt",
  "api_document": "https://useaiblocks.com/api/v1/documents/prompt/google-ads-operator-agent-builder-prompt",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
