Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 estivesse em execução. Quando estiver satisfeito com a saída, você
poderá iniciar a execução de um script ou programá-lo.
O modo de simulação é um recurso eficiente porque permite desenvolver e depurar um script
sem se preocupar com mudanças errôneas nos seus dados do Google Ads.
O modo de simulação afeta apenas as chamadas que usam AdsApp como ponto de entrada. As chamadas para outros serviços vão continuar funcionando normalmente. Por exemplo, se um script estiver usando
MailApp para enviar um e-mail, ele será enviado, mesmo que o script 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 pelas 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.letadGroup=findAnEmptyAdGroup();// Create a keyword.adGroup.createKeyword("test");// Fetch all keywords in the ad group.letkeywords=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());
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003ePreview mode executes scripts without making actual changes to campaign data, allowing for risk-free testing and debugging.\u003c/p\u003e\n"],["\u003cp\u003eIt provides a safe environment to develop and refine Google Ads scripts before applying them to live campaigns.\u003c/p\u003e\n"],["\u003cp\u003eScripts in preview mode can still interact with external services like sending emails or updating spreadsheets.\u003c/p\u003e\n"],["\u003cp\u003eCertain actions, like creating or modifying objects, will not produce the same results in preview mode as in live execution.\u003c/p\u003e\n"],["\u003cp\u003eScripts can determine whether they are running in preview or live mode using execution information.\u003c/p\u003e\n"]]],[],null,["# Preview Mode\n\nWhen scripts are executed in preview mode, they make no changes to the actual\ncampaign data. Instead, script execution shows the changes that **would have**\nbeen made had the script been executing. Once satisfied with the output, you\ncan start the live execution of a script or schedule it.\n\nPreview mode is a powerful feature, as it lets you develop and debug a script\nwithout worrying about erroneous changes being made to your Google Ads data.\n\nPreview mode only affects calls that use `AdsApp` as an entry point. Calls to\nother services will proceed as normal. For example, if a script is using\n`MailApp` to send an email, it will get sent whether or not the script had been\npreviewed or executed. Spreadsheets will get updated in both scenarios as\nwell. A script can find out whether or not it is running in preview mode through\nits [execution info](/google-ads/scripts/docs/concepts/execution-info).\n| **Important:** No objects are created, deleted, or modified during preview. As a consequence, certain code won't execute the same way in preview mode.\n\nThe following snippet won't behave as expected in preview mode: \n\n // Suppose the ad group has no keywords.\n let adGroup = findAnEmptyAdGroup();\n\n // Create a keyword.\n adGroup.createKeyword(\"test\");\n\n // Fetch all keywords in the ad group.\n let keywords = adGroup.keywords().get();\n\n // In preview mode, will log \"false\": keyword was not actually created.\n // In real execution, will log \"true\".\n console.log(\"Are there keywords in the ad group? \" + keywords.hasNext());"]]