Notas da versão

Consulte Descontinuações de recursos para uma lista atualizada das descontinuações de recursos atuais e planejadas.

Versões principais e secundárias da v25

A API Google Ads v25 inclui os seguintes novos recursos, atualizações e mudanças significativas.

v25.2 (17/09/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v25.2. Versões secundárias, como v25.2, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Recursos
Opções de URL para AssetGroup Novos campos Adicionamos suporte para opções de URL em AssetGroup, permitindo que os anunciantes especifiquem modelos de rastreamento, parâmetros personalizados e sufixos do URL final no nível do grupo de recursos:
Campanhas
Informações sobre rastreamento automatizado de vídeos Novos campos e enums Adicionamos AutomatedVideoCrawlSetting a Campaign.AssetAutomationSetting, além de AssetAutomationType.AUTOMATED_VIDEO_CRAWL, para que você possa especificar as configurações de rastreamento automático de vídeo de uma campanha Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos contém uma lista de entradas AutomatedVideoCrawlInfo, cada uma configurando um rastreamento url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL ou YOUTUBE) e o status de ativação enabled.
Erros de multiplicador de valor da otimização do ciclo de vida do cliente Novos valores de enumeração e erros Adicionamos novos motivos de erro de validação ao configurar multiplicadores de valor (value_multiplier e high_lifetime_value_multiplier) para a otimização do ciclo de vida do cliente:
SmartCampaignSettingService.GeneratePMaxDraftCampaign Novo recurso Adicionamos SmartCampaignSettingService.GeneratePMaxDraftCampaign para oferecer suporte à geração de uma campanha PMax de rascunho com base em uma campanha inteligente atual, inicializada com o status CampaignStatus.PAUSED e o status de criação CampaignCreationStatus.INCOMPLETE. Consulte Converter campanhas inteligentes em campanhas PMax:
Conversões
Impressões de anúncios do Firebase Novos tipos e categorias de ações de conversão Exposição dos tipos de ação de conversão FIREBASE_ANDROID_APP_AD_IMPRESSION e FIREBASE_IOS_APP_AD_IMPRESSION, permitindo recuperar e modificar essas ações de conversão. Também expôs a categoria IN_APP_AD_REVENUE em ConversionActionCategory para rastrear a receita de monetização de anúncios no app.
Geral
BusinessProfileLocationSyncError Novo tipo enumerado e erros Adicionamos motivos para os erros de sincronização de local do Perfil da Empresa ao sincronizar locais em um AssetSet do tipo LOCATION_SYNC. Em vez de retornar um erro genérico UNKNOWN, a API agora retorna BusinessProfileLocationSyncError com motivos específicos (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED e NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planejamento
Métricas de percentil BenchmarksService.GenerateBenchmarksMetrics Novos recursos

Atualizamos BenchmarksService.GenerateBenchmarksMetrics para fornecer métricas que representam a posição competitiva do cliente entre outros anunciantes no formato de nível de percentil. As métricas são retornadas em PercentileMetrics no novo campo CustomerMetrics.percentile_metrics (em GenerateBenchmarksMetricsResponse.customer_metrics e BreakdownMetrics.customer_metrics) e representadas usando BenchmarksCustomerPercentileTier.

CustomerMetrics.percentile_metrics só é preenchido quando as duas condições a seguir são atendidas em GenerateBenchmarksMetricsRequest:

Adicionamos suporte a métricas de percentil para datas de trimestre em aberto em ListBenchmarksAvailableDatesResponse.supported_dates (retornadas por BenchmarksService.ListBenchmarksAvailableDates). Embora as métricas agregadas de clientes (CustomerMetrics.aggregate_metrics), de taxa de clientes (CustomerMetrics.average_rate_metrics) e de percentil de clientes (CustomerMetrics.percentile_metrics) sejam compatíveis com todas as datas em supported_dates (incluindo trimestres em aberto), as métricas de participação de clientes (CustomerMetrics.share_metrics) e de taxa da origem dos comparativos de mercado (average_benchmarks_metrics, como average_cpm de anúncios de "/Apparel/Clothing") não são compatíveis com trimestres em aberto e são omitidas da resposta, a menos que o date_range solicitado esteja dentro do intervalo mais restrito ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics.

Adicionamos um erro BenchmarksError.NO_METRICS_FOUND personalizado que indica que não foram encontradas métricas para a combinação selecionada de entradas, melhorando a usabilidade.
Identificadores de canais do YouTube para insights de criadores de conteúdo Novo recurso Atualizamos ContentCreatorInsightsService.GenerateCreatorInsights para permitir a pesquisa por identificadores de canais do YouTube usando YouTubeChannels.youtube_channel_handles. Os identificadores válidos precisam começar com @, como @channel_handle. Essa opção é semelhante à pesquisa por IDs de canais do YouTube. A resposta contém insights sobre os criadores de conteúdo do YouTube solicitados.
Recomendações
Recomendações de lances de CPA e ROAS Novas recomendações Adicionamos Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) e Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), além de ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low e ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, para aumentar o CPA desejado ou diminuir o ROAS desejado quando os lances estão muito baixos para que as campanhas de pesquisa participem dos leilões:
Relatórios
Segmentos de dimensão de itinerário de hotel Novos segmentos Adicionamos os seguintes segmentos de dimensão de itinerário de reserva de hotel e viagem ao Segments (selecionáveis com campaign, ad_group e customer):
Métricas de anúncios verticais Novas métricas Adicionamos as seguintes métricas para relatórios de anúncios de hotéis e viagens em Metrics (selecionáveis com campaign, ad_group e customer):
Segmentos de anúncios verticais Novos segmentos Adicionamos os seguintes segmentos para relatórios de anúncios verticais de hotéis e viagens em Segments (selecionáveis com campaign, ad_group e customer):

v25.1 (19/08/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v25.1. Versões secundárias, como v25.1, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Recursos
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Novos valores de tipo enumerado Adicionamos suporte a recursos de exoneração de responsabilidade por texto.
Campanhas
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Novos campos Acompanhe a próxima migração automática para a IA Max.
Conversões
Medições de Brand Lift Novos recursos Adicionamos suporte às medições de Brand Lift com as seguintes atualizações:
Medições de Conversion Lift Novos recursos Adicionamos suporte para medições do Conversion Lift com as seguintes atualizações:
  • Adição de um novo recurso somente leitura LiftMeasurementConfig que representa um estudo de Lift.
  • Adicionamos novos segmentos selecionáveis para segmentar e filtrar os resultados de Lift.
  • Adicionamos 24 novas métricas de Conversion Lift e pontuação do vencedor que oferecem suporte a uma análise estatística detalhada da performance de Lift.
  • Adicionamos suporte para recuperar detalhes da campanha e metas de conversão.
  • Adicionamos um novo campo opcional Experiment.lift_measurement_config.
  • Adição do tipo enumerado ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Novo recurso Um novo recurso somente leitura que representa os detalhes do período de veiculação para uma configuração de medição de Lift, incluindo as datas de início e término medidas (start_date e end_date).
Geral
SmartCampaignError Novos valores de tipo enumerado Adicionamos novos códigos de erro específicos para restrições de geração de campanhas Performance Max:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Novo valor de tipo enumerado / erro Retornado quando um projeto do Google Cloud com nível de acesso TEST tenta fazer solicitações em uma conta que não é de teste.
Planejamento
Insights sobre o sentimento da marca Novos recursos Adição de suporte aos insights de sentimento da marca em ContentCreatorInsightsService:
Melhorias de BenchmarksService Novos recursos Adição de suporte a categorias como filtros para definir o escopo de uma análise comparativa. Também há suporte para outras métricas essenciais aos negócios:
Segmentação por status parental Novo recurso Adicionamos suporte à segmentação por status parental no planejamento de alcance. Adicionamos o novo campo parental_statuses a Targeting para o serviço ReachPlanService.GenerateReachForecast e parental_statuses a PlannableTargeting para o serviço ReachPlanService.ListPlannableProducts.
Recomendações
Recommendation.campaign_specific_app_goal_recommendation Nova recomendação Sugere adicionar uma meta de conversão de app específica da campanha. O novo recurso EffectiveAutomaticGoal é usado para representar as metas atuais nessa recomendação.
Relatórios
Metrics.original_conversion_value Novo campo Representa o valor original da conversão de conversões passíveis de lances. Esse é o valor não ajustado das conversões antes da aplicação de ajustes, como regras de valor da conversão ou metas de ciclo de vida.
Estatísticas de participação no programa de fidelidade Novos recursos Adicionamos suporte para segmentar estatísticas por status do programa de fidelidade do usuário e a dimensão principal de fidelidade para regras de valor da conversão:
  • Adicionamos o segmento Segments.loyalty_membership para segmentar as métricas do relatório de acordo com o nível do programa de fidelidade do usuário que fez a conversão.
  • Adicionamos a dimensão principal LOYALTY_MEMBERSHIP para identificar quando uma condição de associação a um programa de fidelidade foi atendida para uma regra de valor da conversão.
Segmentação
vertical_ads_item_bid Novo tipo de critério Adição do novo tipo de critério vertical_ads_item_bid a AdGroupCriterion.criterion.

v25 (22/07/2026)

Os seguintes novos recursos, atualizações e mudanças incompatíveis foram adicionados à API Google Ads v25, que é uma versão principal.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Campanhas
Campos independentes additional_value e additional_high_lifetime_value em CustomerLifecycleOptimizationValueSettings Parte de value_adjustment e high_lifetime_value_adjustment oneofs, respectivamente, junto com os novos campos value_multiplier e high_lifetime_value_multiplier Mudança estrutural Atualize as referências a esses campos, já que agora eles fazem parte de oneofs.
Recursos legados CustomerLifecycleGoal e CampaignLifecycleGoal, os serviços correspondentes CustomerLifecycleGoalService e CampaignLifecycleGoalService e configurações/enumerações legadas (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Nenhum Remoção Use o esquema de metas unificadas reformulado:
Geral
Campos de tipo enumerado aninhados em mensagens de solicitação de serviço e resposta do serviço de incentivo:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Campos de enumeração independentes: Renomeação / remoção Use os novos campos de enumeração independente em vez dos campos type legados.
Campos opcionais selected_incentive_id e customer_id em ApplyIncentiveRequest Campos obrigatórios Alteração comportamental Forneça os dois campos ao chamar ApplyIncentive.
O campo de endereço de e-mail do consumidor ContactDetails.email no recurso LocalServicesLead Nenhum Remoção Remova as referências a esse campo porque ele não é mais compatível.
Campo allowed_domain opcional em AdvertisingPartnerLinkInvitationProperties Campo obrigatório ao chamar CreateProductLinkInvitation para um parceiro de publicidade Alteração comportamental Forneça allowed_domain ao criar um convite de vinculação de produto para um parceiro de publicidade.
Planejamento
O campo search_brand em GenerateCreatorInsightsRequest Nenhum Remoção Use search_topics.
O campo plannable_location_id em Targeting e o campo cookie_frequency_cap em GenerateReachForecastRequest Nenhum Remoção Mude para o uso de plannable_location_ids e cookie_frequency_cap_setting.
Relatórios
Campo customer_metrics em GenerateBenchmarksMetricsResponse e BreakdownMetrics do tipo Metrics Campo do tipo CustomerMetrics Mudança de tipo / alteração comportamental Atualize suas integrações para usar o novo tipo CustomerMetrics, que contém apenas métricas que representam a performance do anúncio do cliente.

Recursos e atualizações (sem interrupção)

Recursos e atualizações Tipo Descrição
Anúncios
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Novo valor de tipo enumerado / comportamento Disponível para DemandGenMultiAssetAds. Se ativada, ela gera imagens animadas usando imagens não animadas como entrada. Os novos DemandGenMultiAssetAds são ativados por padrão a partir desta versão da API.
Mutabilidade das informações de conteúdo sintético Mudança de comportamento Asset.synthetic_content_info e Ad.synthetic_content_info agora são totalmente mutáveis nas versões 25, 24 e 23.
Campanhas
Meta de retenção de fidelidade Novos recursos / configurações Adicionamos suporte à meta de retenção de fidelidade, que permite aos anunciantes otimizar campanhas para reter membros do programa de fidelidade.
Meta de aquisição de novos clientes Novos recursos / configurações Atualizamos o suporte à meta de aquisição de novos clientes na API Google Ads para refletir o esquema de metas unificadas reformulado:
Conversões
Atribuição de conversões de terceiros do YouTube Novos campos Adicionamos suporte à verificação da atribuição de conversão do YouTube usando parceiros terceirizados: Para saber mais, consulte o artigo da Central de Ajuda.
Geral
ContactDetails.phone_number_extension Novo campo Adicionado ao recurso LocalServicesLead.
IncentiveError Novos valores de enumeração e erros Adicionamos novos códigos de erro específicos para falhas no resgate de incentivos:
Planejamento
Detalhes do canal do YouTube nos insights em alta Novos campos Agora é possível conferir mais detalhes do canal do YouTube dos vídeos relacionados ao pesquisar insights em alta. Adicionamos os novos campos channel_id, channel_name e channel_url a YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given Novo campo Adicionado a YouTubeChannelInsights. Isso é válido se um criador de conteúdo consentiu em compartilhar dados não públicos. Se for o caso, os seguintes campos serão preenchidos:
Relatórios
ad_sub_format_type Novo segmento Fornece um detalhamento dos anúncios in-stream não puláveis do YouTube por duração: Esse segmento precisa sempre ser selecionado com ad_format_type. Ele pode ser selecionado com AdGroup, AdGroupAd, Campaign, Customer, Video e VideoEnhancement.
Métricas sociais específicas de vídeo Novos campos / métricas Adicionamos métricas sociais específicas de vídeo para ajudar os anunciantes a acompanhar o engajamento do usuário (comentários, marcações "Gostei" e compartilhamentos) nos anúncios do YouTube Shorts: Eles estão disponíveis em AdGroup, AdGroupAd, Asset, Campaign, Customer e Video.

Versões principais e secundárias da v24

A API Google Ads v24 inclui os seguintes novos recursos, atualizações e mudanças incompatíveis.

v24.2 (24/06/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v24.2. Versões secundárias, como v24.2, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Anúncios
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Novo valor de tipo enumerado Gera informações de texto da página de destino para serem mostradas no painel de engajamento para instâncias DemandGenVideoResponsiveAd (que são ativadas por padrão a partir desta versão da API).
Recursos
AssetGroup.google_local_services_info Novo campo Adicionamos suporte às informações dos Anúncios dos Serviços Locais (ID da categoria e frases de destaque) nas campanhas Performance Max.
AssetGroupSignal.local_services_id Novo campo Adicionado para oferecer suporte aos indicadores de ID de serviço dos Anúncios de Serviços Locais nas campanhas Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Novo campo Adicionamos suporte às regras de grupo de itens de anúncios verticais para selecionar itens dos feeds verticais anexados nas campanhas Performance Max. Esse recurso está disponível apenas para contas na lista de permissões.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Novo valor de tipo enumerado / erro Retornado ao tentar remover todos os grupos de recursos de uma campanha.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Novo valor de tipo enumerado / erro Retornado ao tentar remover todos os indicadores de um grupo de recursos.
Campanhas
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Novos campos Ajuda a identificar campanhas Performance Max de Serviços locais.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Novo campo Inclui o Google Maps nos canais selecionáveis para grupos de anúncios da Geração de demanda.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Novo valor de tipo enumerado / erro Retornado ao tentar remover todos os locais de uma campanha Performance Max de serviços locais.
SmartCampaignErrorEnum.CREATION_FAILED Novo valor de tipo enumerado / erro Retornado ao tentar criar campanhas inteligentes.
Conversões
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Novos valores de tipo enumerado Representam as conversões que ocorrem quando um usuário clica em um anúncio de serviços locais e liga, envia mensagens ou faz uma reserva com o anunciante.
Experimentos
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Novos valores de tipo enumerado Adição de suporte para novos tipos de ExperimentType:
  • COMPARE_CAMPAIGNS: para experimentos de mix de campanhas e personalizados da Performance Max que comparam várias campanhas do mesmo tipo ou de tipos diferentes em um único experimento.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: para experimentos de otimização das campanhas Performance Max de personalização de texto e expansão de URL final.
Geral
Asset.synthetic_content_info
Ad.synthetic_content_info		 Novos campos Contêm atestações para conteúdo sintético/conteúdo gerado com IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (atestações detectadas automaticamente ou fornecidas pelo sistema).

Esse recurso foi portado para as versões 23 e 22.

Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis.

Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado:

"O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo".

Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completa quando a v25 for lançada.
Autorização de outra parte Novos recursos Adicionamos suporte para análises de autorização de várias partes (MPA):
Esse recurso foi portado para versões anteriores v23.3, v22.2 e v21.2.
IncentiveService.FetchIncentive Mudança de comportamento Quando um endereço de e-mail inválido é fornecido na solicitação, o método agora volta a retornar as ofertas de incentivo padrão em vez de gerar um erro AuthenticationError.INVALID_EMAIL_ADDRESS.
Planejamento
GenerateCreatorInsightsRequest.search_topics Novo campo Adicionado ao serviço ContentCreatorInsightsService.GenerateCreatorInsights. Essa opção pesquisa criadores de conteúdo que falam sobre um tema no país especificado em country_locations (só é possível pesquisar em um país por vez).
CREATOR_TOPIC_INSIGHTS Novo valor de tipo enumerado Adicionado a InsightsKnowledgeGraphEntityCapabilities para indicar entidades na pesquisa de criadores de conteúdo que falam sobre um tema. Essas entidades precisam ser usadas no campo search_topics. Recuperado usando AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Novo tipo / opções Contém outras opções de pesquisa para tópicos em ListAudienceInsightsAttributes, incluindo opções para recuperar todos os tópicos compatíveis como atributos de criador de conteúdo e filtrar por recursos.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Novos campos Entradas opcionais para os métodos ContentCreatorInsightsService. Ao fornecer esse campo, outros locais ou atributos do criador de conteúdo são preenchidos na resposta.
local_creator_insights
related_local_creators		 Novos campos Preenchido quando supplemental_data contém o tipo enumerado LOCAL_CREATOR_DATA. Mostra criadores de conteúdo locais que assistiram ou estão no país escolhido e que consentiram em compartilhar dados de localização.
GenerateTrendingInsightsRequest.sub_country_locations Novo campo Adicionado a ContentCreatorInsightsService.GenerateTrendingInsights, permitindo pesquisas de insights em alta usando a localização do país e subpaíses.
Relatórios
PerformanceMaxPlacementView Extensão de segmentos Tornou-se segmentável por ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Novo campo Se for verdadeiro, as exclusões de marca serão ignoradas nos anúncios do Shopping. Disponível apenas para campanhas do Shopping.
Segmentação
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Novo valor de tipo enumerado / erro Retornado ao tentar segmentar um idioma que não é permitido.
Vídeos
DataLink.youtube_link_metadata Novo campo Contém brand_channel_id para especificar o ID do canal da marca do YouTube vinculado.

v24.1 (13/05/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v24.1. Versões secundárias, como v24.1, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Anúncios
DemandGenMultiAssetAdInfo.classic_display_images Novo campo Imagens de display personalizadas enviadas e veiculadas sem exigir recursos responsivos extras.
Experimentos
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Novos valores de tipo enumerado Adição de suporte para novos tipos de ExperimentType:
  • ADOPT_AI_MAX: para experimentos que testam como a IA Max pode ajudar você a interagir com mais clientes usando a IA do Google e palavras-chave de correspondência ampla.
  • ADOPT_BROAD_MATCH_KEYWORDS: para experimentos que testam como as palavras-chave de correspondência ampla podem afetar o número de pesquisas em que seus anúncios aparecem.
  • OPTIMIZE_ASSETS: para experimentos personalizados de otimização de recursos.
  • PMAX_REPLACEMENT_SHOPPING: para experimentos que testam a performance das suas campanhas do Shopping em comparação com as campanhas Performance Max.
Experiment.video_experiment Novo campo Suporte à configuração de experimentos YOUTUBE_CUSTOM atuais que consistem em campanhas de vídeo.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Novos campos Expõe campos para oferecer suporte a testes de recursos, grupos de recursos e configurações das campanhas Performance Max nos grupos experimentais:
  • asset_testing_info: detalhes dos recursos associados às cópias experimentais de anúncios.
  • asset_groups: lista de grupos de recursos no grupo experimental para experimentos de otimização de recursos.
  • performance_max_experiment_arm_info: configurações para campanhas Performance Max em experimentos PMAX_REPLACEMENT_SHOPPING.
Geral
CustomerUserAccess.passkey_enabled Novo campo Campo somente leitura que indica se o usuário tem uma chave de acesso ativada.
Relatórios
mobile_device_platform Novo segmento Permite segmentar relatórios pela plataforma do dispositivo do usuário (como iOS ou Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Novo valor de tipo enumerado / erro Retornado quando a granularidade temporal diária, por hora ou semanal solicitada não é compatível com os períodos da consulta (disponível apenas para os últimos 37 meses).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Novos segmentos Novos segmentos para serem usados em anúncios verticais.
user_rating, venue, event_participant_display_name Novos critérios de filtro Adição de suporte à filtragem em VerticalAdsItemGroupRuleInfo para o recurso SharedCriterion.
Métricas de experimento de controle/tratamento Novos campos Adição de valores de controle (control_clicks etc.), valores de tratamento (clicks etc.), estimativas pontuais (clicks_point_estimate etc.), margens de erro (clicks_margin_of_error etc.) e valores de p (clicks_p_value etc.) em sete famílias de métricas principais (cliques, impressões, custo, conversões, custo por conversão, valor da conversão, valor da conversão por custo).
Métricas de mudança absoluta de conversões Novos campos Suporte para Conversions estimativas de diferença absoluta usando campos de estimativa pontual, margem de erro e valor p.
Segmentação
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Novo valor de tipo enumerado / erro Retornado ao tentar excluir todas as segmentações demográficas.
Vídeos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Novo valor de tipo enumerado Publicamos a ZEFR como um parceiro de integração de visibilidade de terceiros.
DataLink.youtube_video.channel_id Novo campo Expõe o ID do canal do YouTube associado à vinculação de dados.

v24 (22/04/2026)

Os seguintes novos recursos, atualizações e mudanças incompatíveis foram adicionados à API Google Ads v24, que é uma versão principal.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Anúncios
videos e logo_images opcionais em DemandGenVideoResponsiveAdInfo Campos obrigatórios Alteração comportamental Forneça videos e logo_images ao criar ou mudar anúncios em vídeo responsivos da Geração de demanda.
videos, business_name e logo_images opcionais em VideoResponsiveAdInfo Campos obrigatórios Alteração comportamental Forneça videos, business_name e logo_images ao criar ou mudar anúncios responsivos em vídeo. VideoResponsiveAdInfo agora é mutável.
Campanhas
Campaign.video_brand_safety_suitability Nenhum Remoção O controle de adequação no nível da campanha é removido. A adequação de brand safety ainda está disponível no nível do cliente. Use Customer.video_brand_safety_suitability.
Conversões
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Nenhum Remoção A categoria de usuário "Inscrições no programa de fidelidade" foi removida. Remova as referências de código a ele.
Planejamento
Tipo de InsightsAudienceAttributeGroup para topic_audience_combinations Tipo de common.InsightsAudienceAttributeGroup Alteração comportamental / mudança de tipo As integrações de bibliotecas de cliente tipadas precisam ser atualizadas para usar os novos namespaces de recursos.
Campo youtube_select_lineups em ReachPlanService.ListPlannableProducts Nenhum Remoção Mude para usar as seleções do youtube_select_lineup_targeting.
Campo is_brand_connect_creator em ContentCreatorInsightsService.GenerateCreatorInsights e GenerateTrendingInsights Nenhum Remoção Em vez disso, verifique se um criador de conteúdo tem o CREATOR_PARTNERSHIPS disponível em partnership_opportunities.
geo_modifiers e biddable_keywords no KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants e keywords Renomeação / remoção Substituído por CampaignToForecast.geo_target_constants[] e ForecastAdGroup.keywords[].
Campos descontinuados de plano / previsão de palavras-chave em GenerateKeywordForecastMetrics Nenhum Remoção Os seguintes campos e tipos de plano / previsão foram removidos: Atualize as integrações conforme necessário.
Relatórios
Segmento ad_sub_network_type em campaign_budget Nenhum Remoção O segmento ad_sub_network_type foi removido do recurso campaign_budget.
Segmento click_type nas visualizações de recursos Nenhum Remoção O segmento foi removido das visualizações AdGroupAsset, CampaignAsset e CustomerAsset.
Vídeos
Falha parcial permitida em ShareablePreviewService.GenerateShareablePreviews Nenhuma falha parcial Alteração comportamental As solicitações vão falhar e gerar um erro se algum ID dentro delas não passar na validação.
Códigos legados do ShareablePreviewError: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Renomear / alteração comportamental Os códigos de erro retornados para grupos de recursos são modificados para se alinhar aos erros de anúncios do grupo de anúncios. Atualize a lógica de captura de validação.

Recursos e atualizações (sem interrupção)

Recursos e atualizações Tipo Descrição
Anúncios
Mutabilidade de VideoResponsiveAdInfo Mudança de comportamento Os objetos de informações dos anúncios responsivos em vídeo agora são mutáveis.
Recursos
travel_feed_data em AssetSet Novo campo Adicionado para recuperar atributos de recursos do feed de viagens (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Campanhas
Campaign.view_through_conversion_optimization_enabled Novo campo Permite ativar a otimização de conversão de visualização (VTC) (padrão false) em campanhas Geração de Demanda e para apps.
CampaignCriterion.gender Novo recurso Ativamos as exclusões de gênero para campanhas Performance Max em todas as versões da API Google Ads.
Conversões
Tipos de conversão de Geração de demanda Novos valores de tipo enumerado Adicionamos novas enumerações de tipo de ação de conversão do GA4/Firebase em ConversionActionType:
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
Geral
UserListErrorEnum.DUPLICATE_LOOKALIKE Novo valor de tipo enumerado / erro Retornado ao tentar criar várias listas de público-alvo semelhantes idênticas.
Planejamento
Campos ProductCoreAttributes em ListPlannableProductsResponse Novos campos Adicionamos a descrição do produto planejável, o objetivo de marketing, o modelo de custo e o método de compra a ProductCoreAttributes em ListPlannableProductsResponse.
Relatórios
CartDataSalesView Novo recurso de relatórios Mostra relatórios que segmentam as métricas de conversão pelo produto específico vendido (marca etc.), além do produto clicado.
Métricas que não recebem lances Novos campos Adicionamos métricas que não recebem lances (métricas que mostram conversões que as campanhas não estão otimizando) a todos os recursos correspondentes:
conversion_attribution_event_type Novo segmento Adicionado a ShoppingPerformanceView.
Shopping
Campanhas para apps em ShoppingProduct Novo recurso Campanhas para apps compatíveis no recurso ShoppingProduct. Não há suporte para status e problemas de observação.
Filtragem de produtos com base em tags Novo recurso Introduzimos a filtragem usando expressões de conjunto lógico de forma dinâmica: Esse recurso está disponível apenas para contas na lista de permissões.

Versões principal e secundária da v23

A API Google Ads v23 inclui os seguintes novos recursos, atualizações e mudanças significativas.

v23.3 (24/06/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v23.3. As versões secundárias, como v23.3, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Geral
Asset.synthetic_content_info
Ad.synthetic_content_info		 Novos campos Contêm declarações para conteúdo sintético/gerado por IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (declarações detectadas ou fornecidas automaticamente pelos sistemas do Google).

Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source vão permanecer imutáveis.

Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado:

"O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo".

Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completos quando a v25 for lançada.
Aprovações de outras partes Novos recursos Adicionamos suporte para análises de aprovações de várias partes (MPA):

v23.2 (25/03/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v23.2. Versões secundárias, como v23.2, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Recursos
VideoEnhancement Novo recurso Contém informações específicas sobre anúncios em vídeo aprimorados, como se foram gerados pelo Google ou fornecidos pelo anunciante. Saiba mais em Sobre as melhorias de vídeos.
AppTopCombinationView Novo recurso Recurso somente leitura para fornecer insights sobre as combinações de recursos de melhor performance em campanhas para apps.
CustomerAsset Novo recurso Foi adicionado suporte para recuperar CustomerAsset com field_type definido como BUSINESS_LOGO.
Campanhas
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Novos campos Forneça restrições de programação mais detalhadas nas datas da campanha. Essa opção só é compatível com alguns tipos de grupo de anúncios.
HotelSettingInfo.disable_hotel_setting Novo campo Permite desativar o feed de hotel em campanhas Geração de demanda.
Geral
CustomerClientLinkError Novos valores de tipo enumerado / erros Adicionamos dois novos códigos de erro: MAX_CUSTOMER_LIMIT_REACHED e ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Mudança de comportamento Agora, um erro é gerado ao tentar usar essa categoria de tipo de cliente da lista de usuários descontinuada.
Planejamento
GenerateTrendingInsights
GenerateCreatorInsights		 Novos recursos Adicionamos suporte a combinações personalizadas de entidades, tópicos e públicos-alvo com operadores AND/OR.
ReachPlanService.GenerateReachForecast Novos valores de tipo enumerado Adicionamos novas faixas etárias segmentáveis, como AGE_RANGE_21_44 ou AGE_RANGE_21_49.
youtube_select_lineup_targeting Novo campo Adicionado a ReachPlanService.ListPlannableProducts, que vai substituir youtube_select_lineups. Os dois campos estão preenchidos no momento.
ReachPlanSurface Novo valor de tipo enumerado Adição de IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS como uma opção de plataforma.
Forecast Novo campo Adicionamos clicks para o CPC máximo de cliques da Geração de demanda em ReachPlanService.GenerateReachForecast.
partnership_opportunities Novo campo Adicionado a ContentCreatorInsightsService.GenerateCreatorInsights e ContentCreatorInsightsService.GenerateTrendingInsights.
Relatórios
biddable_indirect_install_first_in_app_conversion_micros Novo campo Adicionado aos recursos Campaign, Customer e AdGroup.
Vídeos
ShareablePreviewService Novo recurso Estendida para oferecer suporte às prévias do YouTube ao vivo definindo preview_type como YOUTUBE_LIVE_PREVIEW. UNSUPPORTED_AD_TYPE e TOO_MANY_RESOURCES_IN_REQUEST foram adicionados a ShareablePreviewError. Essa opção só é compatível com alguns tipos de anúncio.

v23.1 (25 de fevereiro de 2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v23.1. As versões secundárias, como v23.1, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Gerenciamento da conta
advertising_partner_properties.allowed_domain Novo campo Adicionado aos recursos ProductLinkInvitation e ProductLink. O parceiro de publicidade só poderá anunciar nesse domínio.
Customer.contains_eu_political_advertising Novo campo Recupera o status da declaração no nível da conta sobre se ela contém propaganda política segmentada para a UE e retorna um EuPoliticalAdvertisingStatus.
Campanhas
Campaign.text_guidelines Novo campo Adicionamos suporte para diretrizes de texto, que podem ser usadas com campanhas Performance Max e de pesquisa para controlar programaticamente recursos de texto gerados por IA. Em text_guidelines, é possível definir term_exclusions e messaging_restrictions.
CampaignPrimaryStatusReason Novos valores de tipo enumerado Adição de CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED e BOOKING_CANCELLED para fornecer os principais motivos de status das campanhas com a estratégia de lances FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Novos campos Adicionamos suporte para autodeclaração da categoria de anúncios de reserva e detalhes de reserva somente leitura.
Campaign.missing_eu_political_advertising_declaration Novo campo Permite consultar e filtrar campanhas que não têm declarações sobre se contêm publicidade política segmentada para a UE.
Conversões
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Novo valor de tipo enumerado Ajuda a rastrear usuários que assistem um anúncio e depois um vídeo do mesmo canal.
Geral
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Novo valor de tipo enumerado / erro Retornado ao tentar segmentar apenas a categoria "Indeterminado" nas dimensões demográficas.
Incentivos
IncentiveErrorEnum Novos valores de tipo enumerado / erros Adicionamos dois novos códigos de erro: MAX_INCENTIVES_REDEEMED e ACCOUNT_TOO_OLD. Esses erros podem ser retornados para solicitações feitas a partir de 11 de março de 2026.
Planejamento
GenerateBenchmarksMetrics Novo recurso Adicionamos suporte para detalhamentos de data usando um BreakdownDefinition.
ReachPlanService.GenerateReachForecast Novo valor de tipo enumerado Adicionamos o GOOGLE_DISPLAY_NETWORK como uma plataforma segmentável para a Geração de demanda e a estratégia de lances Maximizar conversões.
GenerateTrendingInsights Novos campos Adicionamos informações de linha de tendência histórica em TrendInsightDataPoint para TrendInsights ao pesquisar por tema.
Relatórios
Métricas de frequência de usuários únicos Novos campos Adicionamos novas métricas que informam quantos usuários viram seu anúncio pelo menos duas, três, quatro, cinco ou dez vezes: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus e unique_users_ten_plus.
SearchTermMatchSource Novo valor de tipo enumerado Adicionamos VERTICAL_ADS_DATA_FEED para oferecer suporte a feeds de dados de anúncios verticais, como a segmentação por entidade de anúncios de viagem.
YouTubeVideoUpload
YouTubeVideoUpload Novo serviço / recurso Adicionamos o serviço YouTubeVideoUpload para permitir o envio e o gerenciamento de vídeos no YouTube, além do recurso YouTubeVideoUpload para buscar o status do upload e os metadados. Esse recurso só é compatível com REST e a biblioteca de cliente Python.

v23 (28/01/2026)

Os seguintes novos recursos, atualizações e mudanças incompatíveis foram adicionados à API Google Ads v23, que é uma versão principal.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Anúncios
O compartilhamento de anúncios é permitido AdGroupAdError.AD_SHARING_NOT_ALLOWED Alteração comportamental O compartilhamento de anúncios entre vários grupos de anúncios não é mais permitido. As solicitações que tentarem compartilhar anúncios vão retornar um erro AD_SHARING_NOT_ALLOWED.
Suporte para CallAd e CallAdInfo Nenhum Remoção A compatibilidade com anúncios de chamada foi removida. Consulte o artigo da Central de Ajuda Sobre os anúncios de ligação.
Campanhas
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Renomeação / substituição Use os novos campos de data e hora para especificar componentes de tempo para campanhas. Os campos originais somente de data são removidos.
Geração de demanda
DemandGenMultiAssetAdInfo.lead_form_only Nenhum Remoção O campo lead_form_only foi removido. Atualize as referências no seu código.
Relatórios
Agrega métricas de nível de performance de recursos e tipo enumerado. Nenhum Remoção Removemos as métricas de nível de performance de recursos agregados. O tipo enumerado de nível de performance não é mais retornado para a Pesquisa e o Display.

Recursos e atualizações (sem interrupção)

Recursos e atualizações Tipo Descrição
Anúncios
AdFormatType Novos valores de tipo enumerado Adição de novos tipos de formato: TEXT, VERTICAL_ADS_BOOKING_LINK e VERTICAL_ADS_PROMOTION.
Recursos
asset_group visualização Novos campos Adicionamos as seguintes métricas: metrics.engagements, metrics.engagement_rate e metrics.average_cpe.
asset_group_asset visualização Novos campos Adicionamos as seguintes métricas: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views e metrics.interaction_event_types.
Asset.orientation Novo campo Campo de orientação somente leitura adicionado aos recursos de imagem e vídeo.
CampaignAsset Novo recurso Foi adicionado suporte para recuperar recursos de campanha com field_type definido como HEADLINE e DESCRIPTION.
ServedAssetFieldType Novos valores de tipo enumerado Adicionamos HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE e DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO para recursos veiculados como sitelinks.
BusinessMessageAsset Novos recursos / suporte Recursos de mensagem comercial atualizados:
Faturamento
InvoiceService.ListInvoices Novas opções Agora é possível retornar detalhes mais granulares em Invoice, incluindo detalhamento de custos no nível da campanha, custos regulatórios detalhados e informações de ajuste, definindo include_granular_level_invoice_details em ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Novos enums Adicionamos enums auxiliares para tarifas regulamentares e unidades de medida.
Campanhas
CampaignError Novos valores de tipo enumerado / erros Adição dos códigos de erro DURATION_TOO_LONG_FOR_TOTAL_BUDGET e END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversões
ConversionActionCategory Novo valor de tipo enumerado Adicionamos YOUTUBE_FOLLOW_ON_VIEWS para rastrear usuários que assistem um anúncio e depois um vídeo do mesmo canal.
Geração de demanda
DemandGenVideoResponsiveAdInfo.companion_banner Novo campo Adicionamos suporte a banners complementares em anúncios responsivos em vídeo da Geração de demanda.
Incentivos
Adição do suporte a incentivos "Escolha sua própria" (CYO, na sigla em inglês):

Para facilitar o tratamento programático mais granular de falhas, vamos adicionar outros códigos de erro a IncentivesService em versões futuras. Recomendamos que você monitore os próximos anúncios e notas da versão para esses novos códigos de erro e garanta que seus aplicativos possam gerenciar esses novos modos de falha.
Planejamento
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Novo valor de tipo enumerado Permite criar públicos-alvo usando eventos importantes em GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport e GenerateCreatorInsights.

Os eventos importantes não são compatíveis com outros métodos AudienceInsightsService, como AudienceInsightsService.GenerateAudienceOverlap e AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Novos campos / opções A resposta agora inclui plataformas para oferecer suporte a sugestões de taxa de conversão com base em controles de plataforma (por exemplo, Gmail, Shorts). Disponível apenas para campanhas Geração de demanda.
LanguageDistribution Novo campo / tipo Adicionado a YouTubeChannelInsights para fornecer detalhes sobre a distribuição de idiomas no conteúdo do canal do YouTube.
BenchmarksService Novo serviço Compara os dados de publicidade do YouTube com comparativos de mercado.
AudienceInsightsService.GenerateAudienceDefinition Novo método Traduz uma descrição de texto livre de um público-alvo em atributos correspondentes usando a IA generativa.
YouTubeChannelInsights.relevance_score Novo campo Avalia a relevância de um criador de conteúdo para um tema ponderado por visualizações.
TrendInsightMetrics.trend_change_percent Novo campo Representa a mudança percentual no valor de uma tendência durante o período de comparação.
Recomendações
GenerateRecommendationsRequest Novo campo is_new_customer foi adicionado. Quando definido como true para recomendações de CAMPAIGN_BUDGET, ele usa um modelo otimizado para novos clientes (recomendado apenas para clientes sem campanhas).
Relatórios
AdGroupAdAssetView Suporte a novos recursos / métricas Agora oferece suporte a métricas de impressão, performance e conversão para RESPONSIVE_DISPLAY_AD.
Segmento ad_sub_network_type Novo segmento Fornece um detalhamento granular da performance em uma rede de publicidade. Inicialmente disponível para campanhas Geração de Demanda no YouTube (in-stream, in-feed e Shorts). Precisa ser selecionada com ad_network_type.
Relatórios das campanhas Performance Max Novo recurso Ativamos o detalhamento do tipo de rede de publicidade para campanhas Performance Max.
UserLocationView
GeographicView		 Suporte para novos segmentos Métricas de suporte segmentadas por data de conversão: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date e cross_device_conversions_value_by_conversion_date.
Segmentos de anúncios verticais Novos segmentos Adicionamos os seguintes segmentos: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account e vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView		 Novos recursos de relatórios Adicionamos PerStoreView para consultar detalhes do local da loja e MatchedLocationInterestView (para campanhas IA Max) para fornecer métricas de performance por locais geográficos de interesse.
Shopping
ShoppingPerformanceView Suporte a novas métricas Agora é possível usar as seguintes métricas segmentadas por data de conversão: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date e value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Suporte a novas métricas Adição de suporte para: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share e search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri Novo campo Adicionado a ShoppingProduct.
Anúncios verticais
AdGroup.vertical_ads_format_setting Novo campo Permite controlar quais formatos de anúncio podem ser veiculados em campanhas de pesquisa usando feeds de viagem.
AdGroupCriterion
SharedCriterion		 Novos campos / critérios Adicionamos o tipo de critério vertical_ads_item_group_rule_list a AdGroupCriterion e vertical_ads_item_group_rule a SharedCriterion para permitir a segmentação de grupos de itens em campanhas de pesquisa com feeds de viagem.
Integração do feed de dados de anúncios verticais Novo recurso Agora é possível conectar um feed de dados de anúncios verticais a uma campanha de pesquisa que usa a IA Max para mostrar anúncios de promoção de propriedade e de viagem com links para reserva ao lado de anúncios de texto. Controle os formatos com vertical_ads_format_setting e defina regras usando vertical_ads_item_group_rule. Segmentar relatórios por AdFormatType e dimensões do feed de dados de anúncios verticais.
Vídeos
AdVideoAssetInfo.ad_video_asset_feature_control Novo campo Adicionamos opções de controle de recursos para recursos de anúncios em vídeo.
CampaignCriterionError Novo valor de tipo enumerado / erro Adicionamos o código de erro INVALID_VIDEO_LINEUP_ID.
Métricas de audibilidade do YouTube Novas métricas Adicionamos métricas de audibilidade para anúncios em áudio no YouTube, informando se um anúncio estava audível e em quantas impressões a audibilidade pôde ser medida.

Versões principais e secundárias da v22

A API Google Ads v22 inclui os seguintes novos recursos, atualizações e mudanças significativas.

v22.2 (24/06/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v22.2. As versões secundárias, como v22.2, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Geral
Asset.synthetic_content_info
Ad.synthetic_content_info		 Novos campos Contêm declarações para conteúdo sintético/gerado por IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (declarações detectadas ou fornecidas automaticamente pelos sistemas do Google).

Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis.

Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado:

"O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo".

Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completos quando a v25 for lançada.
Aprovações de outras partes Novos recursos Adicionamos suporte para análises de aprovações de várias partes (MPA):

v22.1 (25 de fevereiro de 2026)

O seguinte recurso foi adicionado à API Google Ads v22.1. As versões secundárias, como v22.1, não contêm mudanças interruptivas.

Recursos e atualizações Tipo Descrição
Gerenciamento da conta
Customer.contains_eu_political_advertising Novo campo Recupera o status da declaração no nível da conta sobre se ela contém propaganda política segmentada para a UE e retorna um EuPoliticalAdvertisingStatus.
Campanhas
Campaign.missing_eu_political_advertising_declaration Novo campo Permite consultar e filtrar campanhas que não têm declarações sobre se contêm publicidade política segmentada para a UE.

v22 (15 de outubro de 2025)

Os seguintes novos recursos, atualizações e mudanças incompatíveis foram adicionados à API Google Ads v22, que é uma versão principal.

Consulte Fazer upgrade para a versão mais recente para receber orientações.

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Geração de demanda
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Renomear / correção ortográfica Renomeie as referências para usar o nome de campo corrigido.
Geral
Sem limite de operações em AddBatchJobOperations Limite de 10.000 operações por solicitação Alteração comportamental Verifique se nenhuma solicitação AddBatchJobOperations contém mais de 10.000 operações.
Tamanho da página limitado a 1.000 em ListBatchJobResultsRequest Retorna o erro INVALID_PAGE_SIZE Alteração comportamental Verifique se ListBatchJobResultsRequest.page_size está definido como 1.000 ou menos, porque solicitar um tamanho de página maior agora resulta em um erro.
Performance Max
Rótulos de performance de recursos Nenhum Remoção O suporte aos níveis de performance de recursos e o tipo enumerado de níveis de performance associado foram removidos das campanhas Performance Max. Atualize as integrações conforme necessário.
Campaign.url_expansion_opt_out Sinalização FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION em AssetAutomationSetting Remoção / substituição Use a configuração de automação de recursos de texto para expansão de URL final. O campo de desativação da expansão de URL no nível da campanha é removido.
Planejamento
views trueview_views Remoção / substituição Substitua as referências a views pelo novo campo trueview_views em ReachPlanService.
Vídeos
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Renomeia Atualize as strings de consulta e as integrações para usar os novos nomes de métricas que representam as visualizações de vídeo TrueView.

Recursos e atualizações (sem interrupção)

Recursos e atualizações Tipo Descrição
Recursos
AssetFieldType.LANDING_PAGE_PREVIEW Novo valor de tipo enumerado Adicionado como um novo tipo de campo de recurso de imagem.
AssetGenerationService Novo serviço (Beta) Permite gerar recursos de texto e imagem usando a IA generativa:
  • GenerateText: gera texto com base no URL final, comandos, palavras-chave etc.
  • GenerateImages: gera imagens com base no URL final, comandos ou recontextualização de imagens de produtos.
  • Os erros são retornados com códigos de AssetGenerationError.
Inicialmente disponível apenas para um grupo limitado de participantes do beta fechado.
Campanhas
AppCampaignBiddingStrategyGoalType Novos valores de tipo enumerado Adicionamos novas metas para campanhas de apps para instalações (ACi) que permitem otimizar sem especificar uma meta:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: use com a estratégia padrão "Maximizar conversões".
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Use com a estratégia padrão "Maximizar o Valor de Conversão".
BiddingStrategyType Novo recurso Adicionamos suporte ao tipo de estratégia de lances de participação de voz fixa.
Campaign.feed_types Novo campo Mostra os tipos de feeds anexados a uma campanha. Para campanhas Performance Max, isso pode indicar a categoria de negócios, como MERCHANT_CENTER_FEED para varejo.
Segmentação por conjunto compartilhado Novo recurso Permitido anexar conjuntos compartilhados de palavras-chave negativas a campanhas locais e multicanal (para campanhas para apps).
Geração de demanda
Lances de CPC desejado Novo recurso Adicionamos a estratégia de lances para maximizar os cliques com o CPC desejado: defina o CPC desejado no nível da campanha usando Campaign.target_cpc e substitua no nível do grupo de anúncios usando AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Novo valor de tipo enumerado Se ativada para DemandGenMultiAssetAdInfo, essa opção adiciona elementos de design e incorpora recursos de texto aos recursos de imagem para criar novos recursos com proporções diferentes (ativada por padrão).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Novo valor de tipo enumerado Se ativado para DemandGenMultiAssetAdInfo, ele gera vídeos usando outros recursos, como imagens e texto, que podem ser usados para criar novas instâncias de DemandGenVideoResponsiveAdInfo (ativado por padrão).
Geral
Substituição do tamanho da página ListBatchJobResultsRequest Mudança de comportamento Se page_size não estiver definido ou for 0, o padrão será o máximo de 1.000 (antes retornava INVALID_PAGE_SIZE).
QuotaError Novo valor de tipo enumerado / erro Adição de PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED para indicar quando o limite de taxa de ativação do perfil para pagamentos é excedido.
Performance Max
Configurações de automação de recursos Novos valores de tipo enumerado Adicionamos novas opções de automação de recursos das campanhas PMax:
  • GENERATE_IMAGE_ENHANCEMENT: ativa a criação automática de imagens aprimoradas (corte automático). Ativado por padrão.
  • GENERATE_IMAGE_EXTRACTION: imagens de origem dos URLs finais. O padrão é a configuração de extensão de imagem dinâmica da conta.
Segmentos de relatórios da PMax Novos segmentos Adicionamos novos segmentos exclusivos das campanhas Performance Max:
Planejamento
Listas de dados de parceiros de CRM Novo recurso / valor de tipo enumerado Adicionamos THIRD_PARTY_PARTNER_DATA às fontes de dados de CRM, além de códigos de erro de validação de público-alvo do parceiro (como aceitação dos Termos de Serviço, link ausente etc.).
Métricas de criadores de conteúdo de transmissões ao vivo Novo campo Adicionamos YouTubeMetrics.is_active_live_stream_creator, retornado pelos insights do criador de conteúdo para indicar se um criador publicou uma transmissão ao vivo nos últimos 90 dias.
Metadados de origem de CRM planejáveis Nova mensagem Adicionamos PlannableUserListMetadata em PlannableUserList, retornado por ReachPlanService.ListPlannableUserLists, para mostrar os tipos de fontes de dados de CRM.
Suporte para vídeos e criadores relacionados no TrendInsight Novos campos Adicionamos suporte para related_videos e related_creators em TrendInsight, além de propriedades de observação em video_properties e publish_date.
Melhorias no InsightsFinder Novo recurso O GenerateInsightsFinderReport agora oferece suporte a parental_status, income_ranges e combinações de segmentação AND/OR mais complexas.
Relatórios
Novos tipos de clique Novos valores de tipo enumerado CLICK_TO_MESSAGE_THIRD_PARTY_CLICK e CLICK_TO_MESSAGE_LANDING_PAGE_CLICK foram adicionados.
Segmentação de AssetGroupAsset Suporte para novos segmentos Agora, AssetGroupAsset pode ser segmentado por device, conversion_action, conversion_action_name e conversion_action_category.
RSAs em AdGroupAdAssetView Suporte a novos recursos / métricas Agora, o AdGroupAdAssetView oferece suporte total às métricas de performance e conversão do RESPONSIVE_SEARCH_AD. Antes, apenas as impressões eram retornadas.
Segmentações de métricas de cluster de consultas de análise detalhada Suporte para novos segmentos As métricas clicks_unique_query_clusters, conversions_unique_query_clusters e impressions_unique_query_clusters agora podem ser segmentadas por campos de data.
TargetingExpansionView Novo recurso de relatórios Adicionamos TargetingExpansionView às métricas de relatório para expansões na segmentação manual, como a expansão sem palavras-chave da IA Max para campanhas de pesquisa.
Shopping
Correção do escopo do Shopping Correção de bug Corrigimos o escopo de campanha e grupo de anúncios das métricas no recurso ShoppingProduct.
Metas unificadas
Metas de retenção Novo recurso Adicionamos suporte para metas de retenção de clientes, otimizando o reengajamento de clientes atuais (por exemplo, usando target_option com TARGET_SPECIFIC ou TARGET_ALL).
Vídeos
Métricas de tempo de exibição de vídeo Novos campos Adicionamos métricas de duração do tempo de exibição: video_watch_time_duration_millis (duração total) e average_video_watch_time_duration_millis (duração média por impressão).

Notas de lançamento arquivadas

Consulte Versões descontinuadas para acessar as notas da versão arquivadas.