Modo de visualização

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 alterações que seriam feitas se o script tivesse sido executado. Quando o resultado estiver pronto, é possível iniciar a execução em tempo real de um script ou programá-lo.

O modo de visualização é um recurso eficiente porque permite desenvolver e depurar um script sem se preocupar com alterações incorretas feitas nos dados do Google Ads.

O modo de visualização só afeta chamadas que usam AdsApp como ponto de entrada. As chamadas para outros serviços continuarão normalmente. Por exemplo, se um script estiver usando MailApp para enviar um e-mail, ele será enviado mesmo que o script não tenha 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 usando as 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());