Premiers pas
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Suivez ces étapes pour lancer votre premier script.
Comptes Google Ads
- Connectez-vous à votre compte Google Ads.
- Dans le menu "Outils" du panneau de navigation de gauche, sélectionnez Actions groupées, puis Scripts. Vous pouvez également accéder à cette page en recherchant "Scripts" dans la barre de recherche Google Ads.
- Appuyez sur l'icône +
pour ajouter un script. Vous pouvez parcourir les modèles de script dans le menu déroulant, mais pour cet exercice, sélectionnez "Nouveau script".
- Vous pouvez éventuellement donner un nom à votre script dans le champ de texte "Nom du script". Cela peut vous aider à rester organisé et à vous souvenir de ce que fait le script.
Copiez et collez le code suivant dans la zone de l'éditeur, en remplaçant la fonction principale :
function main() {
// Get the campaign names from all the campaigns
const rows = AdsApp.search('SELECT campaign.name FROM campaign');
console.log('My campaigns:');
// Iterate through the campaigns and print the campaign names
for (const row of rows) {
console.log(row.campaign.name);
}
}
Lorsque vous y êtes invité, cliquez sur Autoriser pour que le script puisse accéder au compte en votre nom. Cette opération doit être effectuée une fois pour chaque script.
Cliquez sur Aperçu pour exécuter le script en mode Aperçu.
Les résultats s'affichent dans le panneau Modifications / Journaux. Dans cet exemple, les noms de vos campagnes doivent s'afficher dans les journaux.
Lorsque vous êtes satisfait des résultats de l'aperçu, cliquez sur Exécuter pour exécuter votre script et ouvrir la page Historique des scripts. Cette page affiche les scripts exécutés le plus récemment, avec des informations sur leur état et leurs résultats.
Pour obtenir une vue détaillée des modifications et des journaux, cliquez sur le lien de la colonne Modifications correspondant au script que vous venez d'exécuter. Vous devriez voir le même résultat de journal que celui qui a été prévisualisé auparavant.
Comptes administrateur
Pour exécuter des scripts Ads Manager, vous devez d'abord disposer d'un compte administrateur Google Ads.
- Connectez-vous à votre compte administrateur Google Ads.
- Dans le menu "Outils" du panneau de navigation de gauche, sélectionnez Actions groupées, puis Scripts. Vous pouvez également accéder à cette page en recherchant "Scripts" dans la barre de recherche Google Ads.
- Appuyez sur l'icône +
pour ajouter un script. Vous pouvez parcourir les modèles de script dans le menu déroulant, mais pour cet exercice, sélectionnez "Nouveau script".
- Vous pouvez éventuellement donner un nom à votre script dans le champ de texte "Nom du script". Cela peut vous aider à rester organisé et à vous souvenir de ce que fait le script.
Copiez et collez le code suivant dans la zone de l'éditeur, en remplaçant la fonction principale :
function main() {
// Retrieve all children accounts.
const accountIterator = AdsManagerApp.accounts().get();
// Iterate through the account list.
for (const account of accountIterator) {
// Get stats for the child account.
const stats = account.getStatsFor("THIS_MONTH");
// And log it.
console.log(`${account.getCustomerId()},${stats.getClicks()},` +
`${stats.getImpressions()},${stats.getCost()}`);
}
}
Lorsque vous y êtes invité, cliquez sur Autoriser pour que le script puisse accéder au compte en votre nom. Cette opération doit être effectuée une fois pour chaque script.
Cliquez sur Aperçu pour exécuter le script en mode Aperçu.
Les résultats s'affichent dans le panneau Modifications / Journaux. Dans cet exemple, vous devriez voir les comptes enfants et leurs métriques affichés dans les journaux.
Lorsque vous êtes satisfait des résultats de l'aperçu, cliquez sur Exécuter pour exécuter votre script et ouvrir la page Historique des scripts. Cette page affiche les scripts exécutés le plus récemment, avec des informations sur leur état et leurs résultats.
Pour obtenir une vue détaillée des modifications et des journaux, cliquez sur le lien de la colonne Modifications correspondant au script que vous venez d'exécuter. Vous devriez voir le même résultat de journal que celui qui a été prévisualisé auparavant.
Pour obtenir d'autres exemples d'extraits de script, consultez notre page d'exemples.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eLaunching your first Google Ads script involves signing in, navigating to the Scripts section, and adding a new script.\u003c/p\u003e\n"],["\u003cp\u003eYou need to copy and paste provided code snippets into the script editor to define its functionality, such as analyzing keywords or account statistics.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary for the script to access your account data, and preview mode allows for testing before full execution.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Ads manager accounts are required to run Ads Manager scripts, which can access and process data from multiple child accounts.\u003c/p\u003e\n"],["\u003cp\u003eMore script examples and resources are available on the Google Ads Scripts examples page for further exploration and customization.\u003c/p\u003e\n"]]],[],null,["# Get started\n\nFollow these steps to launch your first script. \n\n### Google Ads accounts\n\n1. [Sign in](//ads.google.com/) to your Google Ads account.\n2. From the Tools menu in the left navigation, select **Bulk actions** , then **Scripts**. You can also navigate to this page by searching for \"Scripts\" in the Google Ads search bar.\n3. Press the + icon to add a script. You can browse script templates from the drop-down menu, but for the sake of this exercise, select \"New script\".\n4. You can optionally provide a name for your script in the \"Script name\" text field. This can help you stay organized and remember what the script does.\n5. Copy and paste the following code into the editor area, replacing the main\n function:\n\n function main() {\n // Get the campaign names from all the campaigns\n const rows = AdsApp.search('SELECT campaign.name FROM campaign');\n\n console.log('My campaigns:');\n // Iterate through the campaigns and print the campaign names\n for (const row of rows) {\n console.log(row.campaign.name);\n }\n }\n\n6. When prompted, click **Authorize** so the script can access the account on\n your behalf. This has to be done once for each script.\n\n7. Click **Preview** to run the script in [preview mode](/google-ads/scripts/docs/concepts/preview).\n Results will appear in the **Changes** / **Logs** panel. For this example,\n you should see your campaign names displayed in the Logs.\n\n8. When you're happy with the preview results, click **Run** to run your\n script and open the **Script history** page. This page displays the\n most recently run scripts, with information on their status and results.\n\n9. To get a detailed view of changes and logs, click the link in the\n **Changes** column that corresponds to the script you just ran. You should\n see the same log output that was previewed before.\n\n### Manager accounts\n\nYou must first have a\n[Google Ads manager account](//support.google.com/google-ads/answer/6139186)\nto run Ads Manager scripts.\n\n1. [Sign in](//ads.google.com/) to your Google Ads manager account.\n2. From the Tools menu in the left navigation, select **Bulk actions** , then **Scripts**. You can also navigate to this page by searching for \"Scripts\" in the Google Ads search bar.\n3. Press the + icon to add a script. You can browse script templates from the drop-down menu, but for the sake of this exercise, select \"New script\".\n4. You can optionally provide a name for your script in the \"Script name\" text field. This can help you stay organized and remember what the script does.\n5. Copy and paste the following code into the editor area, replacing the main\n function:\n\n function main() {\n // Retrieve all children accounts.\n const accountIterator = AdsManagerApp.accounts().get();\n\n // Iterate through the account list.\n for (const account of accountIterator) {\n // Get stats for the child account.\n const stats = account.getStatsFor(\"THIS_MONTH\");\n // And log it.\n console.log(`${account.getCustomerId()},${stats.getClicks()},` +\n `${stats.getImpressions()},${stats.getCost()}`);\n }\n }\n\n6. When prompted, click **Authorize** so the script can access the account on\n your behalf. This has to be done once for each script.\n\n7. Click **Preview** to run the script in [preview mode](/google-ads/scripts/docs/concepts/preview).\n Results will appear in the **Changes** / **Logs** panel. For this example,\n you should see your children accounts and their metrics displayed in the\n Logs.\n\n8. When you're happy with the preview results, click **Run** to run your\n script and open the **Script history** page. This page displays the\n most recently run scripts, with information on their status and results.\n\n9. To get a detailed view of changes and logs, click the link in the\n **Changes** column that corresponds to the script you just ran. You should\n see the same log output that was previewed before.\n\nFor more sample script snippets, check out our\n[examples page](/google-ads/scripts/docs/examples)."]]