Exécution de scripts en mode préversion

Le mode Aperçu vous permet de tester votre script sans apporter de modifications aux données. Au lieu de cela, vous voyez les résultats comme si le script était exécuté. Cela peut réduire le temps consacré à la configuration des cas de test. Lorsque vous êtes satisfait de la sortie du script, vous pouvez exécuter le script ou le planifier pour qu’il s’exécute ultérieurement.

Pour déterminer par programmation si un script s’exécute en mode aperçu, consultez la isPreview méthode ExecutionInfo.

Étant donné que les objets ne sont pas créés, supprimés ou modifiés en mode d’aperçu, tout le code ne s’exécute pas de la même façon que s’il était exécuté en direct. Le code suivant montre un exemple simple lorsque le code se comporte différemment en mode aperçu et en mode actif.

/function main() {

    // Get an ad group that does not have keywords.
    var adGroup = AdsApp.adGroups()
        .withIds(["123456789"])
        .get()
        .next();

    // Add a keyword to the ad group
    var operation = adGroup.newKeywordBuilder()
        .withText('mykeyword')
        .build();

    // In preview mode, the keyword is not created, so getId() returns -1.
    if (operation.isSuccessful()) {
        var keyword = operation.getResult();
        Logger.log(`added keyword, ${keyword.getText()} (${keyword.getId()})`);
    }
    else {
        for (var error in operation.getErrors()) {
            Logger.log(`Error adding keyword, ${error}.`);
        }
    }

    // Get the ad group's keywords. In preview mode, the
    // keyword is not created, so no keywords are logged.
    var keywords = AdsApp.keywords()
        .withCondition(`AdGroupName CONTAINS '${adGroup.getName()}'`)
        .get();

    while (keywords.hasNext()) {
        var keyword = keywords.next();
        Logger.log(`added keyword, ${keyword.getText()} (${keyword.getId()})`);
    }
}

Prochaines étapes

Découvrez le fonctionnement de l’autorisation