Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Lorsque des scripts sont exécutés en mode Aperçu, ils n'apportent aucune modification aux données réelles de la campagne. Au lieu de cela, l'exécution du script affiche les modifications qui auraient été apportées si le script avait été exécuté. Une fois que vous êtes satisfait du résultat, vous pouvez lancer l'exécution en direct d'un script ou la planifier.
Le mode Aperçu est une fonctionnalité puissante, car il vous permet de développer et de déboguer un script sans vous soucier des modifications erronées apportées à vos données Google Ads.
Le mode Aperçu n'affecte que les appels qui utilisent AdsApp comme point d'entrée. Les appels vers d'autres services se dérouleront normalement. Par exemple, si un script utilise MailApp pour envoyer un e-mail, celui-ci sera envoyé, que le script ait été prévisualisé ou exécuté. Dans les deux cas, les feuilles de calcul seront également mises à jour. Un script peut déterminer s'il s'exécute en mode Aperçu grâce à ses informations d'exécution.
L'extrait suivant ne se comportera pas comme prévu en mode Aperçu :
// Suppose the ad group has no keywords.letadGroup=findAnEmptyAdGroup();// Create a keyword.adGroup.createKeyword("test");// Fetch all keywords in the ad group.letkeywords=adGroup.keywords().get();// In preview mode, will log "false": keyword was not actually created.// In real execution, will log "true".console.log("Are there keywords in the ad group? "+keywords.hasNext());
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/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003ePreview mode executes scripts without making actual changes to campaign data, allowing for risk-free testing and debugging.\u003c/p\u003e\n"],["\u003cp\u003eIt provides a safe environment to develop and refine Google Ads scripts before applying them to live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eScripts in preview mode can still interact with external services like sending emails or updating spreadsheets.\u003c/p\u003e\n"],["\u003cp\u003eCertain actions, like creating or modifying objects, will not produce the same results in preview mode as in live execution.\u003c/p\u003e\n"],["\u003cp\u003eScripts can determine whether they are running in preview or live mode using execution information.\u003c/p\u003e\n"]]],[],null,["# Preview Mode\n\nWhen scripts are executed in preview mode, they make no changes to the actual\ncampaign data. Instead, script execution shows the changes that **would have**\nbeen made had the script been executing. Once satisfied with the output, you\ncan start the live execution of a script or schedule it.\n\nPreview mode is a powerful feature, as it lets you develop and debug a script\nwithout worrying about erroneous changes being made to your Google Ads data.\n\nPreview mode only affects calls that use `AdsApp` as an entry point. Calls to\nother services will proceed as normal. For example, if a script is using\n`MailApp` to send an email, it will get sent whether or not the script had been\npreviewed or executed. Spreadsheets will get updated in both scenarios as\nwell. A script can find out whether or not it is running in preview mode through\nits [execution info](/google-ads/scripts/docs/concepts/execution-info).\n| **Important:** No objects are created, deleted, or modified during preview. As a consequence, certain code won't execute the same way in preview mode.\n\nThe following snippet won't behave as expected in preview mode: \n\n // Suppose the ad group has no keywords.\n let adGroup = findAnEmptyAdGroup();\n\n // Create a keyword.\n adGroup.createKeyword(\"test\");\n\n // Fetch all keywords in the ad group.\n let keywords = adGroup.keywords().get();\n\n // In preview mode, will log \"false\": keyword was not actually created.\n // In real execution, will log \"true\".\n console.log(\"Are there keywords in the ad group? \" + keywords.hasNext());"]]
