Product overview
Stay organized with collections
Save and categorize content based on your preferences.
Google Ads scripts provide a way to programmatically manage and query your Google Ads data
using JavaScript in a browser-based IDE. Most features of Google Ads are available
in Google Ads scripts through mutate
and search
calls. You can use scripts to automate common procedures or interact with
external data—for one to many Google Ads accounts.
Why use scripts?
Google Ads scripts may be right for you if:
Prerequisites
Only entry-level familiarity with JavaScript is needed—the IDE helps with
syntax highlighting, auto-complete, and previewing. All you need is a
Google Ads account to start writing your first script.
Feedback
If you have any feedback on Google Ads scripts, we would love to hear it! Reach
out to us on Discord.
If you need support,
contact scripts technical support.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-10 UTC."],[[["\u003cp\u003eGoogle Ads scripts allow you to automate Google Ads tasks and interact with external data using JavaScript within a browser-based IDE.\u003c/p\u003e\n"],["\u003cp\u003eBasic JavaScript knowledge is sufficient to get started, and a Google Ads account is all you need.\u003c/p\u003e\n"],["\u003cp\u003eThe new Google Ads scripts experience offers a rewritten backend with benefits like ES6 support, improved performance, better validation, and enhanced campaign bidding strategy support.\u003c/p\u003e\n"],["\u003cp\u003eYou can easily transition to the new infrastructure using a toggle within the script editor.\u003c/p\u003e\n"],["\u003cp\u003eFeedback on Google Ads scripts is encouraged and can be shared through the designated forum.\u003c/p\u003e\n"]]],[],null,["Google Ads scripts provide a way to programmatically manage and query your Google Ads data\nusing JavaScript in a browser-based IDE. Most features of Google Ads are available\nin Google Ads scripts through [mutate](https://developers.google.com/google-ads/scripts/docs/features/mutate)\nand [search](https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp#search_query-optArgs)\ncalls. You can use scripts to automate common procedures or interact with\nexternal data---for one to many Google Ads accounts.\n\nWhy use scripts?\n\nGoogle Ads scripts may be right for you if:\n\n- You want to make changes to your Google Ads account programmatically, without needing to set up a server or coding environment.\n- You want to apply [Bulk Uploads](https://developers.google.com/google-ads/scripts/docs/features/bulk-upload) or [manage Video Campaigns](https://developers.google.com/google-ads/scripts/docs/features/video-campaigns) programmatically.\n- You want to [manage advertiser accounts at the manager level](https://developers.google.com/google-ads/scripts/docs/features/manager-scripts) by writing one script that can access all serving child accounts.\n- You want to schedule scripts to run without needing an [active user session](https://developers.google.com/google-ads/scripts/docs/concepts/authorization#why_authorization_is_necessary).\n- You want to integrate with other [Google APIs](https://developers.google.com/google-ads/scripts/docs/features/advanced-apis) or [third party APIs](https://developers.google.com/google-ads/scripts/docs/features/third-party-apis).\n- Your script will take [less than 30 minutes to run](https://developers.google.com/google-ads/scripts/docs/limits) (or 60 minutes if run in parallel from a manager account).\n\nPrerequisites\n\nOnly entry-level familiarity with JavaScript is needed---the IDE helps with\nsyntax highlighting, auto-complete, and previewing. All you need is a\n[Google Ads](//ads.google.com) account to start writing your first script.\n\nFeedback\n\nIf you have any feedback on Google Ads scripts, we would love to hear it! Reach\nout to us on [Discord](//goo.gle/google-ads-discord).\n\nIf you need support,\n[contact scripts technical support](/google-ads/scripts/docs/support/contact)."]]
