Lorsque les scripts sont exécutés en mode Aperçu, ils ne modifient pas les 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 de la sortie, vous pouvez lancer l'exécution en direct d'un script ou le planifier.
Le mode Preview est une fonctionnalité puissante, car il vous permet de développer et de déboguer un script sans vous soucier de la modification erronée de vos données Google Ads.
Le mode Preview n'affecte que les appels qui utilisent AdsApp comme point d'entrée. Les appels vers d'autres services se poursuivront normalement. Par exemple, si un script utilise MailApp pour envoyer un e-mail, il est envoyé, que le script ait été prévisualisé ou exécuté ou non. Les feuilles de calcul seront également mises à jour dans les deux scénarios. Un script peut déterminer s'il s'exécute en mode Preview à l'aide de ses informations d'exécution.
L'extrait de code 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());