Exécution de scripts en mode Aperçu

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

Pour déterminer par programmation si un script s’exécute en mode prévisualisation, consultez la isPreview méthode d’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écutera pas de la même manière que s’il était exécuté en direct. Le code suivant montre un exemple simple où le code se comporte différemment en mode aperçu et en mode réel.

/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()})`);
    }
}

Étapes suivantes

Découvrez comment fonctionne l’autorisation