Começar

Siga estas etapas para iniciar seu primeiro script.

Contas do Google Ads

1. Faça login na sua conta do Google Ads.
2. No menu "Ferramentas" na navegação à esquerda, selecione Ações em massa e Scripts. Você também pode acessar essa página pesquisando "Scripts" na barra de pesquisa do Google Ads.
3. Pressione o ícone + para adicionar um script. Você pode navegar pelos modelos de script no menu suspenso, mas, para este exercício, selecione "Novo script".
4. Opcionalmente, você pode dar um nome ao script no campo de texto "Nome do script". Isso ajuda a manter a organização e lembrar o que o script faz.

5. Copie e cole o código a seguir na área do editor, substituindo a função principal:

   function main() {
     // Get the campaign names from all the campaigns
     const rows = AdsApp.search('SELECT campaign.name FROM campaign');
   
     console.log('My campaigns:');
     // Iterate through the campaigns and print the campaign names
     for (const row of rows) {
       console.log(row.campaign.name);
     }
   }
   

6. Quando solicitado, clique em Autorizar para que o script possa acessar a conta em seu nome. Isso precisa ser feito uma vez para cada script.

7. Clique em Visualizar para executar o script no modo de visualização. Os resultados vão aparecer no painel Alterações / Registros. Neste exemplo, os nomes das campanhas vão aparecer nos registros.

8. Quando estiver satisfeito com os resultados da visualização, clique em Executar para executar o script e abrir a página Histórico de scripts. Essa página mostra os scripts executados mais recentemente, com informações sobre o status e os resultados.

9. Para ter uma visão detalhada das mudanças e dos registros, clique no link da coluna Alterações que corresponde ao script que você acabou de executar. Você vai ver a mesma saída de registro que foi visualizada antes.

Contas de administrador

Primeiro, você precisa ter uma conta de administrador do Google Ads para executar scripts do Ads Manager.

1. Faça login na sua conta de administrador do Google Ads.
2. No menu "Ferramentas" na navegação à esquerda, selecione Ações em massa e Scripts. Você também pode acessar essa página pesquisando "Scripts" na barra de pesquisa do Google Ads.
3. Pressione o ícone + para adicionar um script. Você pode navegar pelos modelos de script no menu suspenso, mas, para este exercício, selecione "Novo script".
4. Opcionalmente, você pode dar um nome ao script no campo de texto "Nome do script". Isso ajuda a manter a organização e lembrar o que o script faz.

5. Copie e cole o código a seguir na área do editor, substituindo a função principal:

   function main() {
     // Retrieve all children accounts.
       const accountIterator = AdsManagerApp.accounts().get();
   
     // Iterate through the account list.
     for (const account of accountIterator) {
       // Get stats for the child account.
       const stats = account.getStatsFor("THIS_MONTH");
       // And log it.
       console.log(`${account.getCustomerId()},${stats.getClicks()},` +
         `${stats.getImpressions()},${stats.getCost()}`);
     }
   }
   

6. Quando solicitado, clique em Autorizar para que o script possa acessar a conta em seu nome. Isso precisa ser feito uma vez para cada script.

7. Clique em Visualizar para executar o script no modo de visualização. Os resultados vão aparecer no painel Alterações / Registros. Neste exemplo, as contas vinculadas e as métricas delas vão aparecer nos registros.

8. Quando estiver satisfeito com os resultados da visualização, clique em Executar para executar o script e abrir a página Histórico de scripts. Essa página mostra os scripts executados mais recentemente, com informações sobre o status e os resultados.

9. Para ter uma visão detalhada das mudanças e dos registros, clique no link da coluna Alterações que corresponde ao script que você acabou de executar. Você vai ver a mesma saída de registro que foi visualizada antes.

Para mais exemplos de snippets de script, consulte nossa página de exemplos.