Os scripts do Google Ads oferecem uma plataforma de automação sem servidor que permite gerenciar e consultar de forma programática seus dados de anúncios do Google Ads 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 rotineiros de gerenciamento de contas, 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 chamadas mutate e search. Você pode usar scripts para:
- Gerenciar campanhas, grupos de anúncios, palavras-chave e anúncios.
- Ajuste lances, orçamentos e status com base na performance em tempo real ou em dados externos.
- Execute consultas usando a linguagem de consulta do Google Ads (GAQL) para gerar relatórios e painéis personalizados.
- Programe execuções automatizadas para serem executadas por hora, dia, semana, mês ou sob demanda.
- Coordene operações em várias contas secundárias usando scripts de administrador.
- Conecte-se aos serviços do Google Workspace (como o Planilhas e o Drive), do Google Cloud (como o BigQuery) e a APIs de terceiros.
Os scripts também incluem seletores de entidade e relatórios integrados.
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 retorno de chamada
(30 minutos padrão)
|
| Mecanismo de ambiente de execução | Ambiente de execução JavaScript V8 (ECMAScript 6+) | Ambiente de execução JavaScript V8 (ECMAScript 6+) |
| Limite do iterador de entidade | 50.000 entidades padrão por iterador (relatórios e consultas de pesquisa estão isentos) | 50.000 entidades por conta secundária (relatórios e consultas de pesquisa estã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 as 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 fazer a integração com a API Google Ads. Tenho facilidade para escrever código e gerenciar infraestrutura de software, incluindo servidores e bancos de dados. | Use a API Google Ads. | Controle total de APIs, maior capacidade de processamento, hospedagem dedicada e gerenciamento de OAuth. |
| Sou um desenvolvedor que se sente confortável escrevendo código, mas prefiro não gerenciar minha própria infraestrutura de software. | Usar scripts do Google Ads. | Execução sem servidor no Google Ads, programação automatizada, IDE baseado em navegador. |
| Não sou desenvolvedor, mas quero investir algum tempo aprendendo programação para automatizar o Google Ads. | Usar scripts do Google Ads. | Sintaxe simples de JavaScript, modelos de script pré-criados, preenchimento automático de IDE e destaque de sintaxe. |
| Quero gerenciar campanhas de vídeo de forma programática. | Use os 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. | Usar scripts do Google Ads. | Autorização em segundo plano do OAuth2 com programação automatizada por hora, diária, semanal ou mensal. |
| Quero acessar minhas contas aninhadas do Google Ads de forma programática. | Use scripts de administrador para acessar contas secundárias de veiculação em 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. | Use as APIs do Google ou as APIs de terceiros com os scripts do Google Ads. |
Serviços integrados do Google Workspace (Planilhas, Drive, Mail), APIs avançadas do Google (BigQuery, Analytics, YouTube) e UrlFetchApp para
APIs REST externas.
|
| Sou analista de dados (ou função semelhante) e quero baixar relatórios do Google Ads para fazer mais análises. | Use o serviço de transferência de dados do BigQuery para o Google Ads. | Pipeline automatizado e 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 em 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 interface ou para computador sem código para atualizações em massa e regras programadas. |
Pré-requisitos
É necessário apenas um conhecimento básico de JavaScript. O ambiente de desenvolvimento integrado ajuda com destaque de sintaxe, preenchimento automático e visualização. Você só 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 os 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.
Qual é a diferença entre os scripts do Google Ads e a 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 do OAuth.
Preciso de um servidor para executar os scripts do Google Ads?
Não. Os scripts do Google Ads são executados inteiramente na infraestrutura em nuvem do Google sem custo adicional. Você pode criar scripts, testá-los com o modo de visualização e programá-los diretamente na 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 alterações feitas antes do cancelamento. Consulte Limites
para ver 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 arquivos do 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, fale com a gente. Entre em contato conosco no Discord.
Se precisar de ajuda, entre em contato com o suporte técnico de scripts.