Quando os scripts são executados no modo de visualização, eles não alteram os dados reais da campanha. Em vez disso, a execução do script mostra as mudanças que teriam sido feitas se o script tivesse sido executado. Quando estiver satisfeito com a saída, você poderá iniciar a execução em tempo real de um script ou programá-lo.
O modo de pré-visualização é um recurso poderoso, porque permite desenvolver e depurar um script sem se preocupar com alterações erradas nos dados do Google Ads.
O modo de visualização só afeta as chamadas que usam AdsApp como ponto de entrada. As chamadas para
outros serviços vão continuar normalmente. Por exemplo, se um script estiver usando
MailApp para enviar um e-mail, ele será enviado, independentemente de o script ter sido
visualizado ou executado. As planilhas também serão
atualizadas nos dois cenários. Um script pode descobrir se está sendo executado no modo de visualização ou não nas informações de execução.
O snippet a seguir não vai se comportar como esperado no modo de visualização:
// 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());