Executar scripts no modo de Pré-visualização
O modo de pré-visualização permite-lhe testar o script sem realmente fazer alterações aos dados. Em vez disso, são-lhe apresentados os resultados como se o script tivesse sido executado. Isto pode reduzir a quantidade de tempo despendido a configurar casos de teste. Quando estiver satisfeito com a saída do script, pode executar o script ou agende-o para ser executado mais tarde.
Para determinar programaticamente se um script está a ser executado no modo de pré-visualização, veja o isPreview método executionInfo.
Uma vez que os objetos não são criados, eliminados ou modificados no modo de pré-visualização, nem todos os códigos serão executados da mesma forma que se fossem executados em direto. O código seguinte mostra um exemplo simples quando o código se comporta de forma diferente no modo de pré-visualização em comparação com o modo em direto.
/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()})`);
}
}