Os scripts do Google Ads oferecem uma plataforma de automação sem servidor que permite gerenciar e consultar dados de anúncios do Google Ads de forma programática usando JavaScript moderno (ES6+) em um ambiente de desenvolvimento integrado (IDE) baseado em navegador. Com os scripts do Google Ads, é possível automatizar fluxos de trabalho de gerenciamento de contas de rotina, gerar relatórios personalizados e integrar o Google Ads a fontes de dados externas em uma ou milhares de contas sem provisionar servidores ou gerenciar credenciais de desenvolvedor.
A maioria dos recursos do Google Ads está disponível nos scripts do Google Ads por meio de mutação e pesquisa chamadas. Você pode usar scripts para:
- Gerenciar campanhas, grupos de anúncios, palavras-chave, e anúncios.
- Ajustar lances, orçamentos e status com base na performance em tempo real ou em dados externos.
- Executar consultas usando a linguagem de consulta do Google Ads (GAQL) para gerar relatórios e painéis personalizados.
- Programar execuções automatizadas para serem executadas por hora, dia, semana, mês ou sob demanda.
- Coordenar operações de várias contas em contas secundárias usando scripts de administrador.
- Conectar-se aos serviços do Google Workspace (como Planilhas e Drive), aos serviços do Google Cloud (como o BigQuery) e às APIs de terceiros.
Os scripts também incluem seletores de entidades integrados e relatórios .
Principais especificações técnicas
As especificações técnicas a seguir definem o ambiente de execução e os limites operacionais dos scripts do Google Ads:
| Especificação | Script de conta única | Script de conta de administrador |
|---|---|---|
| Tempo limite de execução | Máximo de 30 minutos |
Até 60 minutos com executeInParallel e um callback
(30 minutos padrão)
|
| Mecanismo de execução | Tempo de execução de JavaScript V8 (ECMAScript 6 ou mais recente) | Tempo de execução de JavaScript V8 (ECMAScript 6 ou mais recente) |
| Limite do iterador de entidades | 50.000 entidades padrão por iterador (relatórios e consultas de pesquisa são isentos) | 50.000 entidades por conta secundária (relatórios e consultas de pesquisa são isentos) |
| Contas paralelas | N/A (1 conta) | Até 50 contas em paralelo |
| Limite de upload em massa | Tamanho do arquivo de 50 MB, 1.000.000 de linhas | Tamanho do arquivo de 50 MB, 1.000.000 de linhas |
| Scripts autorizados | Até 250 scripts autorizados por usuário | Até 250 scripts autorizados por usuário |
| Hospedagem e infraestrutura | Totalmente gerenciado pelo Google (sem servidor) | Totalmente gerenciado pelo Google (sem servidor) |
Para mais informações, consulte Limites.
Os scripts do Google Ads são o produto certo para mim?
O Google oferece vários produtos para ajudar a automatizar contas do Google Ads. A tabela a seguir descreve cenários e recomendações comuns para ajudar você a escolher o produto certo para suas necessidades:
| Cenário | Recomendação | Principais características |
|---|---|---|
| Sou um desenvolvedor que quer criar meu próprio produto de software ou integrar com a API Google Ads. Tenho experiência em escrever código e gerenciar infraestrutura de software incluindo servidores e bancos de dados. | Use a API Google Ads. | Controle total da API, maior capacidade de processamento, hospedagem dedicada e gerenciamento do OAuth. |
| Sou um desenvolvedor que tem experiência em escrever código, mas prefiro não gerenciar minha própria infraestrutura de software. | Use scripts do Google Ads. | Execução sem servidor no Google Ads, programação automatizada, IDE baseado em navegador. |
| Não sou desenvolvedor, mas estou disposto a investir algum tempo aprendendo programação para automatizar o Google Ads. | Use scripts do Google Ads. | Sintaxe simples de JavaScript, modelos de script pré-criados, preenchimento automático e destaque de sintaxe do IDE. |
| Quero gerenciar campanhas de vídeo de forma programática. | Use scripts do Google Ads. |
Gerenciamento direto de campanhas de vídeo usando
AdsApp.videoCampaigns().
|
| Quero programar tarefas para serem executadas sem precisar de uma sessão de usuário ativa. | Use scripts do Google Ads. | Autorização em segundo plano do OAuth2 com programação automatizada por hora, dia, semana, ou mês. |
| Quero acessar minhas contas aninhadas do Google Ads de forma programática. | Use scripts de administrador para acessar contas secundárias de veiculação de um único script. |
Iteração sequencial em contas secundárias ou execução paralela em
até 50 contas secundárias usando executeInParallel.
|
| Quero integrar APIs do Google ou de terceiros ao meu gerenciamento do Google Ads management. | Use APIs do Google ou APIs de terceiros com scripts do Google Ads. |
Serviços integrados do Google Workspace (Planilhas, Drive, E-mail), APIs avançadas do Google
APIs (BigQuery, Analytics, YouTube) e UrlFetchApp para
APIs REST externas.
|
| Sou um analista de dados (ou função semelhante) que quer fazer o download de relatórios do Google Ads para análise mais detalhada. | Use o serviço de transferência de dados do BigQuery para o Google Ads. | Pipeline automatizado programado para dados de anúncios do Google Ads no BigQuery sem código. |
| Quero gerenciar o Google Ads em massa e não me importo de escrever código. | Use uploads em massa com scripts do Google Ads. | Upload programático de CSV ou planilha com suporte para até 1.000.000 de linhas. |
| Quero gerenciar o Google Ads em massa, mas não quero escrever nenhum código. | Use regras automatizadas, uploads em massa, ou o Google Ads Editor. | Ferramentas de desktop ou de interface do usuário sem código para atualizações em massa e regras programadas. |
Pré-requisitos
Só é necessário ter familiaridade básica com JavaScript. O IDE ajuda com destaque de sintaxe, preenchimento automático e visualização. Tudo o que você precisa é de uma conta do Google Ads para começar a escrever seu primeiro script.
Perguntas frequentes
Encontre respostas para perguntas comuns sobre a arquitetura, os limites de execução e as integrações dos scripts do Google Ads.
O que são scripts do Google Ads?
Os scripts do Google Ads oferecem um ambiente de automação sem servidor no Google Ads. Eles permitem que anunciantes e desenvolvedores escrevam código JavaScript para consultar métricas de performance, criar e modificar campanhas, atualizar lances e orçamentos e se conectar a APIs externas sem configurar servidores, gerenciar tokens OAuth ou pagar pela infraestrutura.
Como os scripts do Google Ads são diferentes da API Google Ads?
Os scripts do Google Ads são executados diretamente na sua conta do Google Ads usando JavaScript, não exigem infraestrutura de servidor e processam a autorização automaticamente no navegador. A API Google Ads é uma API REST e gRPC projetada para aplicativos empresariais de maior escala, ferramentas de terceiros e pipelines de dados de alto volume que são executados nos seus próprios servidores e exigem tokens de desenvolvedor dedicados e credenciais OAuth.
Preciso de um servidor para executar scripts do Google Ads?
Não. Os scripts do Google Ads são executados inteiramente na infraestrutura em nuvem do Google sem custo adicional. É possível criar scripts, testá-los com o modo de visualização e programá-los diretamente em a interface da Web do Google Ads.
Quais são os limites de execução dos scripts do Google Ads?
Os scripts padrão em contas individuais podem ser executados por até 30 minutos por execução. Os scripts de conta de administrador que usam executeInParallel podem ser executados por até 60 minutos em até 50 contas secundárias (quando uma função de callback é especificada). Se um script expirar, o Google Ads ainda vai aplicar as mudanças feitas antes do cancelamento. Consulte Limites
para detalhes completos sobre tempos limite, cotas e limites de upload em massa.
Os scripts do Google Ads podem se conectar a APIs externas?
Sim. Os scripts do Google Ads incluem serviços integrados, como SpreadsheetApp para ler e gravar Google Planilhas, UrlFetchApp para enviar solicitações HTTP a APIs REST externas e APIs avançadas do Google para integração com serviços como BigQuery e YouTube. Para mais detalhes, consulte
APIs de terceiros
e APIs avançadas do Google.
Feedback
Se você tiver algum feedback sobre os scripts do Google Ads, gostaríamos de saber! Entre em contato conosco no Discord.
Se precisar de suporte, entre em contato com o suporte técnico de scripts.