Sexta-feira, 1º de maio de 2026
A partir de 1º de junho de 2026, o Google Ads e as APIs de medição relacionadas vão adotar uma política de retenção de dados de 37 meses para estatísticas de performance detalhadas (diárias, por hora e semanais). Os dados agregados (mensais, trimestrais e anuais) vão continuar disponíveis por 11 anos.
| API | Impacto | Próximas etapas |
| API Google Ads e scripts do Google Ads | A partir de 1º de junho de 2026, as consultas que solicitarem segmentos granulares (como segments.date, segments.week) de intervalos anteriores a 37 meses da data atual vão retornar um erro DateRangeError.INVALID_DATE. As versões futuras da API vão retornar o erro DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED.
Para recuperar dados com mais de 37 meses, você precisa atualizar suas consultas para usar segments.month, segments.quarter ou segments.year. Para ter sucesso, as consultas não segmentadas de dados históricos precisam estar perfeitamente alinhadas com os limites do mês (do primeiro ao último dia do mês).
|
Revise e atualize seus aplicativos. Se você precisar de dados históricos granulares com mais de 37 meses, recomendamos exportá-los antes do prazo de 1º de junho de 2026.
Se tiver dúvidas, entre em contato pelo nosso canal de suporte da API Google Ads ou pelo canal de suporte aos scripts do Google Ads. |
| API Google Analytics Data | A API Google Analytics Data vai truncar as métricas afetadas para o período mais recente de 36 meses se a dimensão "data" também for usada no relatório. As métricas afetadas incluem custo, cliques e impressões do anúncio do anunciante. Somente os relatórios com todas as métricas afetadas, de 37 meses ou mais, e que incluem a dimensão "data" são afetados. As dimensões equivalentes a datas, como "Dia da semana" e "Dia", também são afetadas. | Revise sua lógica de agrupamento de dados para considerar esse truncamento. |
| API DV360 e API CM360 | No momento, essas APIs mantêm um período de retenção de 24 meses, que não vai mudar. | Não. |
| Serviço de transferência de dados do BigQuery | A partir de 1º de junho de 2026, os conectores do serviço de transferência de dados do BigQuery para o Google Ads e do serviço de transferência de dados do BigQuery para o Search Ads 360 vão deixar de preencher dados para preenchimentos com datas anteriores a 37 meses da data atual. Os dados transferidos e armazenados no BigQuery vão permanecer nas tabelas sem impacto.
A partir de 1º de junho de 2026, o conector do serviço de transferência de dados do BigQuery para o Google Analytics 4 vai parar de preencher dados para execuções de preenchimento com datas anteriores a 37 meses da data atual. Os dados transferidos e armazenados no BigQuery vão permanecer nas tabelas, mas se uma transferência de dados for acionada manualmente para uma data de relatório de 37 meses ou mais, os dados da data na tabela do BigQuery serão substituídos por um valor vazio. |
Se você quiser manter dados históricos com mais de 37 meses no BigQuery, recomendamos iniciar as execuções de preenchimento com antecedência para que elas sejam concluídas antes de 1º de junho de 2026. |
Se tiver dúvidas ou quiser discutir este post, entre em contato com a gente no nosso servidor do Discord "Google Advertising and Measurement Community".
Nadine Wang, equipe de APIs de publicidade e medição
Marcadores: google-ads-api, google-ads-scripts, google-analytics-api