Limites

Esta página lista os vários limites e limitações dos scripts do Google Ads aos quais você deve estar atento. Esses limites podem ser alterados a qualquer momento sem aviso prévio. Sendo assim, garanta que seus scripts sejam flexíveis e que contenham manipulação de erros.

Limites de tempo de execução

Os scripts do Google Ads para contas de anunciantes podem ser executados por um máximo de 30 minutos. Depois desse tempo, eles serão cancelados. Todas as alterações realizadas antes do cancelamento do script serão aplicadas.

Scripts do Gerenciador de anúncios

Normalmente, os scripts do Gerenciador de anúncios podem ser executados por um máximo de 30 minutos. Depois disso, eles são cancelados. No entanto, se um script do Gerenciador de anúncios usar o método executeInParallel para processar contas em paralelo e especificar um método de callback, ele poderá ser executado por um máximo de 60 minutos antes de ser cancelado. Isso é ilustrado na figura a seguir, em que processAccount é a função paralela e allFinished é o método de callback ao chamar executeInParallel.

Todas as alterações realizadas antes do cancelamento do script serão aplicadas.

Limites da entidade

Scripts de contas do Google Ads

  • Um único iterador vai retornar no máximo 50.000 resultados por padrão. É possível modificar isso chamando withLimit() no seletor.

  • Um único seletor pode processar no máximo 10.000 IDs em selector.withIds(). Se 10.000 ou mais IDs forem especificados, selector.get() vai gerar um erro de execução. Da mesma forma, especificar uma condição Id IN [LIST] com uma lista de IDs

    10.000 vai resultar em um erro de execução.

  • O registro de saídas será truncado em 100 KB. Se isso ocorrer, um aviso será registrado.

Scripts de contas de administrador

  • Cada conta processada por um script do Gerenciador de anúncios recebe uma cota própria, conforme listado acima.

  • Ao usar o método executeInParallel, um script pode processar até 50 contas.

  • O método processAccount de executeInParallel pode retornar até 10 MB de dados.

Limites de upload em massa

  • O arquivo de upload tem um limite de 50 MB e um milhão de linhas. Ele será rejeitado no envio se exceder esses limites.

  • A tarefa de upload expira depois de duas horas e o processamento dos dados restantes será interrompido no arquivo enviado.

Cotas para os serviços do Google

Os serviços de Script do Google Apps subjacentes impõem cotas diárias e limites rígidos em alguns recursos. Confira uma lista dessas cotas e as mensagens de exceção correspondentes.

Scripts autorizados

OAuth2 é usado para autorizar scripts. Cada conta tem um limite de 250 scripts autorizados. Além desse limite, um dos scripts previamente autorizados será desautorizado. Essa situação é apenas temporária. O script poderá ser autorizado novamente da próxima vez que for aberto.

Se você atingir esse limite com frequência, considere usar várias contas de usuário para autorizar diferentes conjuntos de scripts.

Campanhas de vídeo e do Shopping

O seletor de campanha padrão (AdsApp.campaigns().get()) vai filtrar as campanhas de vídeo e shopping dos resultados. Em vez disso, use os seletores de campanha dedicados: