Lorsque les scripts sont exécutés en mode Aperçu, ils ne modifient pas les données réelles des campagnes. À la place, l'exécution du script montre les modifications qui auraient été apportées si le script avait été exécuté. Une fois que vous êtes satisfait des résultats, vous pouvez lancer l'exécution en direct d'un script ou le planifier.
Le mode Aperçu est une fonctionnalité puissante, car il vous permet de développer et de déboguer un script sans craindre d'apporter des modifications erronées à vos données Google Ads.
Le mode Aperçu ne concerne que les appels qui utilisent AdsApp comme point d'entrée. Les appels vers d'autres services se déroulent normalement. Par exemple, si un script utilise MailApp pour envoyer un e-mail, il sera envoyé, que le script ait été prévisualisé ou exécuté ou non. Les feuilles de calcul seront également mises à jour dans les deux cas. Un script peut vérifier s'il est exécuté en mode Aperçu ou non 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.
let adGroup = findAnEmptyAdGroup();
// Create a keyword.
adGroup.createKeyword("test");
// Fetch all keywords in the ad group.
let keywords = 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());