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 Google Ads Manager

Os scripts do Gerenciador de anúncios podem ser executados normalmente por um máximo de 30 minutos depois dos quais serão cancelados. No entanto, se um script do Google Ads Manager 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 abaixo, 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

  • O padrão de um único iterador é, no máximo, 50.000 resultados retornados. É 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 Google Ads Manager recebe a própria cota, 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 é limitado a 50 MB e um milhão de linhas e será rejeitado após o 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. Para ver uma lista dessas cotas e mensagens de exceção correspondentes, consulte esta página.

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ê costuma atingir esse limite, use várias contas de usuário para autorizar diferentes conjuntos de scripts.

Campanhas de vídeo e do Shopping

O seletor de campanhas padrão (AdsApp.campaigns().get()) vai remover as campanhas de vídeo e do Shopping dos resultados. Use os seletores de campanha dedicados: