Mudanças para apoiar a regulamentação de anúncios políticos na União Europeia na API Google Ads e nos scripts do Google Ads

Quinta-feira, 7 de agosto de 2025

O que está mudando?

Conforme anunciado no ano passado, o Google vai parar de veicular propaganda política na União Europeia antes que uma nova regulamentação entre em vigor em outubro de 2025. Em 3 de setembro de 2025, a API Google Ads e os scripts do Google Ads vão implementar restrições relacionadas a essa mudança. Se você usa um desses produtos para criar ou gerenciar campanhas, talvez seja necessário atualizar seu aplicativo para lidar com essas restrições antes de 3 de setembro de 2025.

Suporte da API para autodeclaração de anúncios políticos na UE

A API Google Ads e os scripts do Google Ads agora permitem que você declare se uma campanha tem anúncios políticos na UE. Saiba qual é a definição de um anúncio político na UE neste link. As versões v19.2, v20.1 e v21 da API contêm um novo campo chamado contains_eu_political_advertising no objeto Campaign.. Os valores possíveis e o significado deles são mostrados na tabela abaixo.

Valor	Significado
CONTAINS_EU_POLITICAL_ADVERTISING	A campanha tem anúncios políticos na UE.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	A campanha não tem anúncios políticos na UE.
UNSPECIFIED	A campanha não tem uma autodeclaração sobre anúncios políticos na UE.

Para recuperar o status de autodeclaração de uma campanha na API Google Ads, execute a consulta a seguir usando os métodos Search ou SearchStream do GoogleAdsService. Para scripts do Google Ads, use os métodos AdsApp.search ou AdsApp.report.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Se você usa as bibliotecas de cliente da API Google Ads, talvez seja necessário fazer o download da versão mais recente da biblioteca para usar essa funcionalidade nas versões v19 e v20 da API.

Mudanças na validação e aplicação da API

Em 3 de setembro de 2025, a API Google Ads e os scripts do Google Ads vão começar a aplicar as seguintes verificações nas versões v19 e v20 da API.

• Todas as novas campanhas criadas pela API Google Ads ou pelos scripts do Google Ads precisam definir o campo contains_eu_political_advertising. A chamada de API para criar uma campanha usando CampaignService.MutateCampaigns vai falhar com um erro FieldError.REQUIRED se esse campo não estiver definido. Os scripts do Google Ads vão aplicar essas verificações ao criar campanhas usando os métodos AdsApp.mutate ou AdsApp.mutateAll.
• Todas as campanhas atuais precisam definir o campo contains_eu_political_advertising antes de tentar mudar a segmentação por proximity, location, ou location_group no nível da campanha ou do grupo de anúncios. A chamada de API para criar ou atualizar esses critérios de campanha usando o método CampaignCriterionService.MutateCampaignCriteria para campanhas atuais vai falhar com um erro CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se a campanha não tiver concluído a autodeclaração. A chamada de API para criar ou atualizar esses critérios do grupo de anúncios usando AdGroupCriterionService.MutateAdGroupCriteria também vai falhar de maneira semelhante se a campanha não tiver concluído a autodeclaração. Os scripts do Google Ads vão aplicar essas verificações ao tentar mudar a segmentação usando os métodos AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity e AdsApp.Campaign.addLocation.
• Essas restrições também se aplicam a outros mecanismos que você pode usar para criar campanhas, como executar jobs em lote e usar o método GoogleAdsService.Mutate para criar e atualizar entidades.
• Se você tentar programar um novo experimento usando o método ExperimentService.ScheduleExperiment, vai receber um erro ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se o contains_eu_political_advertising declaration estiver ausente nas campanhas de rascunho de tratamento.
• Se você usa o recurso de upload em massa nos scripts do Google Ads, consulte a documentação do produto para saber mais sobre as mudanças necessárias no modelo de planilha.

Essas verificações já são aplicadas na versão v21 da API Google Ads.

Como isso vai afetar a veiculação da minha campanha?

Todas as campanhas que declararam anúncios políticos na UE definindo contains_eu_political_advertising como true vão deixar de veicular anúncios na UE em 22 de setembro de 2025.. Consulte nossa Central de Ajuda para saber mais.

As campanhas atuais sem uma declaração não serão afetadas por enquanto. Recomendamos que você atualize as campanhas atuais nas suas contas com uma declaração adequada o mais rápido possível. É possível recuperar campanhas sem uma declaração usando a seguinte consulta GAQL com os métodos Search ou SearchStream do GoogleAdsService.

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

O que preciso fazer?

Se o aplicativo usa a API Google Ads ou os scripts do Google Ads para criar ou gerenciar campanhas, atualize-o para lidar com essas restrições antes de 3 de setembro de 2025.

Como posso receber ajuda?

Entre em contato com os canais de suporte da API Google Ads ou dos scripts do Google Ads se tiver mais dúvidas sobre essa mudança.

 - Anash P. , equipe da API Google Ads

Marcadores: campanha, google-ads-api, google-ads-scripts