{
 "schema": "aiblocks-page/1",
 "id": "google-ads-oauth-setup-planner",
 "type": "skill",
 "name": "Google Ads OAuth setup planner",
 "summary": "Plan your Google Cloud project, Ads API access and OAuth client. Get a setup checklist with field names, access limits and what to do next.",
 "headline": "Google Ads OAuth setup planner",
 "subhead": "Tell it your app and who owns the Google Cloud project and the Google Ads accounts. It lays out each setup step, picks the OAuth client type that fits and keeps secrets out of the output. You get a checklist to finish before you ask for a token.",
 "job": {
  "id": "connect-tools",
  "name": "Connect AI to your tools"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "codebase",
   "required": false,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "code_change",
   "required": false,
   "label": "Code change",
   "what": "a change to the code, with what it fixes and how it was checked"
  }
 ],
 "you_give": [
  "Your code project, or a short description of the app that will connect (a local script, an installed app or a web app)",
  "Who owns the Google Cloud project and the Google Ads manager account",
  "The Ads account you want to read",
  "Where the app will run, so redirect addresses can be chosen (optional)",
  "What you allow the AI to do, such as plan only or also edit files"
 ],
 "you_get": [
  "A setup checklist for the Cloud project, the Ads API and the OAuth client",
  "The names of the fields to fill in, never the secret values",
  "A map of manager and target accounts with the IDs hidden",
  "The least access Google offers for your use",
  "The steps left before a token, and the checks that did not run"
 ],
 "use_when": [
  "You are connecting an app to the Google Ads API for the first time.",
  "You are not sure which OAuth client type fits your app.",
  "You have a manager account and are unsure which account ID goes where.",
  "You want a read-only setup and need to know what Google lets you limit."
 ],
 "skip_when": [
  "You already have the client and want to test the developer token and a read-only call: use Google Ads developer access checker.",
  "You want to audit the campaigns themselves: use Google Ads store account auditor.",
  "You need the connector code written: use API connector builder."
 ],
 "output_sample": {
  "input": [
   "Your code project or a short description of the app",
   "Who owns the Cloud project and the Ads manager account",
   "The Ads account you want to read",
   "Whether the use is read-only"
  ],
  "prerequisites": [
   "A Google account that can create or edit the Cloud project",
   "Access to the Google Ads manager and the account you want to read"
  ],
  "output": [
   {
    "name": "Setup checklist",
    "contains": "Cloud project, API switched on, consent screen and redirect addresses for your client type."
   },
   {
    "name": "OAuth client choice",
    "contains": "The client type that fits your app and the redirect addresses to register."
   },
   {
    "name": "Account map",
    "contains": "How the manager and target accounts link, with every ID hidden."
   },
   {
    "name": "Access boundary",
    "contains": "The least access Google offers for your use, and what your own code must enforce."
   },
   {
    "name": "Remaining steps",
    "contains": "What is left before a refresh token, to hand to the next planner."
   },
   {
    "name": "Evidence and gaps",
    "contains": "The sources used, open questions and the checks that did not run."
   }
  ]
 },
 "how_to_use": [
  "Open the skill in Claude, ChatGPT or Gemini, or paste it in. To change code in your project, use Claude Code or another assistant that can read your files.",
  "Tell it who owns the Cloud project and the Ads accounts, and where the app will run.",
  "Ask it to check Google's current setup pages first, because screens change. It needs web access for this. Without it, it marks the steps as unchecked.",
  "Never paste a client secret or token into the chat. Keep them in your secrets settings.",
  "When the checklist is done, run the Google Ads token and access check planner."
 ],
 "checks": [],
 "next": [
  {
   "name": "Google Ads developer access checker",
   "url": "https://useaiblocks.com/skills/google-ads-developer-access-setup-planner",
   "why": "Google Ads developer access checker"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/worked-example.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/google-ads-oauth-setup-planner",
  "markdown": "https://useaiblocks.com/skills/google-ads-oauth-setup-planner.md",
  "json": "https://useaiblocks.com/skills/google-ads-oauth-setup-planner.json",
  "instructions": "https://useaiblocks.com/skills/google-ads-oauth-setup-planner/SKILL.md",
  "download": "https://useaiblocks.com/skills/google-ads-oauth-setup-planner.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/google-ads-oauth-setup-planner",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/google-ads-oauth-setup-planner",
  "mcp": "https://useaiblocks.com/mcp"
 }
}