Notas da versão

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

Versões principal e secundária da v24

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

v24.2 (24/06/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v24.2. Versões secundárias, como a 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 do serviço dos Anúncios dos Serviços Locais nas campanhas Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Novo campo Adicionamos suporte a regras de grupo de itens de anúncios verticais para selecionar itens de feeds verticais anexados em 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 Conter declarações para conteúdo sintético/gerado por IA, dividido em advertiser_input (declarações fornecidas diretamente pelo anunciante) e system_input (declarações detectadas ou fornecidas automaticamente pelo sistema).

Esse recurso foi adaptado 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 mutação de campos de declaração do anunciante 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 para essas versões.

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

"O campo que foi 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 várias partes 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 falando sobre um tema no país especificado em country_locations (permite pesquisar apenas um país).
CREATOR_TOPIC_INSIGHTS Novo valor de tipo enumerado Adicionado a InsightsKnowledgeGraphEntityCapabilities para indicar entidades ao pesquisar criadores de conteúdo falando sobre um tema. Essas entidades devem 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. Fornecer esse campo preenche outros locais ou atributos do criador de conteúdo 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 consentiram em compartilhar dados de localização e que estão no país escolhido ou assistiram vídeos nele.
GenerateTrendingInsightsRequest.sub_country_locations Novo campo Adicionado a ContentCreatorInsightsService.GenerateTrendingInsights, permitindo pesquisas de insights em alta usando a localização do país e sublocalizações.
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 novos recursos e atualizações a seguir foram adicionados à API Google Ads v24.1. As 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 de tempo 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 a serem usados para 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 das conversões Novos campos Suporte para estimativas de diferença absoluta de Conversions 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 Mudança comportamental Forneça videos e logo_images ao criar ou fazer mutações em anúncios em vídeo responsivos da Geração de demanda.
videos, business_name e logo_images opcionais em VideoResponsiveAdInfo Campos obrigatórios Mudança comportamental Forneça videos, business_name e logo_images ao criar ou mudar anúncios responsivos em vídeo. Observe que VideoResponsiveAdInfo agora é mutável.
Campanhas
Campaign.video_brand_safety_suitability Nenhum Remoção O controle de adequação no nível da campanha foi 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 Mudança de comportamento / 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 o uso de 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 em KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants e keywords Renomeação / remoção Substituído por CampaignToForecast.geo_target_constants[] e ForecastAdGroup.keywords[].
Campos de plano / previsão de palavras-chave descontinuados em GenerateKeywordForecastMetrics Nenhum Remoção Removemos os seguintes campos e tipos de plano / previsão: 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 Mudança 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		 Mudança de nome / comportamento 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 de 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árias da v23

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

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 automaticamente ou fornecidas pelos sistemas do Google).

Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para mutação de campos de declaração do anunciante 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 para essas versões.

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

"O campo que foi 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.
Aprovações de outra parte Novos recursos Adicionamos suporte para análises de aprovações de outra parte (MPA):

v23.2 (25/03/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v23.2. As 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. Consulte a seção Sobre as melhorias de vídeo para saber mais.
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 Adição de 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 hotéis em campanhas Geração de demanda.
Geral
CustomerClientLinkError Novos valores de tipo enumerado / erros Dois novos códigos de erro foram adicionados: 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 desativada.
Planejamento
GenerateTrendingInsights
GenerateCreatorInsights		 Novos recursos Adicionamos suporte a combinações personalizadas de entidades, temas 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 Adicionamos IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS como uma opção de plataforma.
Forecast Novo campo Adicionamos clicks para o Máximo de cliques (CPC) 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 Permite 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 indeterminada nas dimensões demográficas.
Incentivos
IncentiveErrorEnum Novos valores de tipo enumerado / erros Dois novos códigos de erro foram adicionados: 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 Adição de suporte para detalhamentos de data usando um BreakdownDefinition.
ReachPlanService.GenerateReachForecast Novo valor de tipo enumerado Adicionamos GOOGLE_DISPLAY_NETWORK como uma plataforma segmentável para a Geração de demanda e o recurso 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ário único 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 envio 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
Compartilhamento de anúncios permitido AdGroupAdError.AD_SHARING_NOT_ALLOWED Mudança comportamental Não é mais permitido compartilhar anúncios entre vários grupos de anúncios. 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 call.
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 pesquisa e display.

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

Recursos e atualizações Tipo Descrição
Anúncios
AdFormatType Novos valores de tipo enumerado Adicionamos 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 Adicionamos 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		 Novas enumerações Adicionamos enums auxiliares para tarifas regulamentares e unidades de medida.
Campanhas
CampaignError Novos valores de tipo enumerado / erros Foram adicionados os 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 acompanhar os 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 de suporte a incentivos "Escolha sua opção" (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 Adicionamos 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 do setor.
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 tópico 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 para 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 junto 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 viagens.
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 imóveis 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 de 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 Adição do 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 principal e secundária 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. Versões secundárias, como v22.2, não contêm mudanças incompatíveis.

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 automaticamente ou fornecidas pelos sistemas do Google).

Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para mutação de campos de declaração do anunciante 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 para essas versões.

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

"O campo que foi 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.
Aprovações de outra parte Novos recursos Adicionamos suporte para análises de aprovações de outra parte (MPA):

v22.1 (25 de fevereiro de 2026)

O novo recurso a seguir 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 Correção de ortografia / renomeação 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 Mudança comportamental Verifique se nenhuma solicitação AddBatchJobOperations contém mais de 10.000 operações.
Tamanho da página limitado silenciosamente a 1.000 em ListBatchJobResultsRequest Retorna o erro INVALID_PAGE_SIZE Mudança 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 foi 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		 Renomeações 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, nos comandos ou na 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 da 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 Permitimos 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 de 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 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 de 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 para criadores de conteúdo para indicar se um criador publicou uma transmissão ao vivo nos últimos 90 dias.
Metadados de origem do CRM planejáveis Nova mensagem Adicionamos PlannableUserListMetadata em PlannableUserList, retornado por ReachPlanService.ListPlannableUserLists, para mostrar os tipos de origem de dados do CRM.
Suporte para vídeos e criadores relacionados no TrendInsight Novos campos Adição de 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 é compatível com 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 para novos recursos / métricas Agora, o AdGroupAdAssetView oferece suporte total às métricas de performance e conversão para 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 para informar métricas de expansões em relação à 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).

Versões principais e secundárias da v21

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

v21.2 (24/06/2026)

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

Recursos e atualizações Tipo Descrição
Geral
Aprovações de outra parte Novos recursos Adicionamos suporte para análises de aprovações de outra parte (MPA):

v21.1 (25 de fevereiro de 2026)

Os novos recursos e atualizações a seguir foram adicionados à API Google Ads v21.1. Versões secundárias, como v21.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 EuPoliticalAdvertisingStatusEnum.
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.

v21 (06/08/2025)

Os seguintes novos recursos, atualizações e mudanças incompatíveis foram adicionados à API Google Ads v21, 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
Retorna CriterionError.INVALID_LISTING_GROUP_HIERARCHY Retorna CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Mudança no código de erro Para solicitações com falha parcial ativada, processe o novo código de erro em vez do código de erro da hierarquia original.
Conversões
Acesso ao modo debug_enabled no ConversionUploadService Nenhum Remoção O campo debug_enabled é removido. Atualize o código que faz referência a ele para não definir nem consultar esse parâmetro.
Mudanças na publicidade política na UE
Autodeclarações opcionais de campanha para publicidade política na UE Campo contains_eu_political_advertising obrigatório para novas campanhas Regra de validação / mudança comportamental As chamadas de API para criar novas campanhas vão falhar com um erro FieldError.REQUIRED se esse campo não for definido. A partir de 22 de setembro de 2025, as campanhas declaradas como CONTAINS_EU_POLITICAL_ADVERTISING não serão mais veiculadas na UE.
Critérios modificáveis sem autodeclaração Falha ao atualizar com CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regra de validação / mudança comportamental Defina o status de autodeclaração antes de tentar criar ou atualizar critérios de segmentação por proximidade, local ou grupo por locais no nível da campanha ou do grupo de anúncios para campanhas atuais.
Experimentos sem requisitos de autodeclaração Falha ao atualizar com ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regra de validação / mudança comportamental Verifique se as autodeclarações foram concluídas nas campanhas do experimento.
Performance Max
O padrão de brand_guidelines_enabled é false. O valor padrão é true. Mudança comportamental Para novas campanhas Performance Max, as diretrizes da marca são ativadas por padrão. Defina explicitamente o campo como false se eles precisarem ser desativados.
Planejamento
Tipo de argumento de entrada original para AudienceInsightsService.GenerateTargetingSuggestionMetrics Entrada do tipo InsightsAudience Mudança de tipo Atualize as implementações para transmitir o novo tipo de entrada, que oferece suporte a uma combinação AND-of-ORs de interesses do usuário, permitindo métricas de alcance em potencial para definições de público-alvo personalizado.

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

Recursos e atualizações Tipo Descrição
AI Max para campanhas de pesquisa
ai_max_setting.enable_ai_max em Campaign Novo campo Permite que a IA Max expanda a correspondência de termos de pesquisa (respeitando a automação de recursos de texto e as listas de marcas anteriores até serem desativadas). O campo Campaign.ai_max_setting.bundling_required indica se a IA Max precisa ser ativada para respeitar/modificar essas configurações, e AdGroup.ai_max_ad_group_setting.disable_search_term_matching pode desativar a correspondência no nível do grupo de anúncios. Consulte Leve sua performance para outro nível com a IA Max para campanhas de pesquisa.
CampaignError.AI_MAX_MUST_BE_ENABLED Novo valor de tipo enumerado / erro Gerado ao ativar a automação de recursos de texto de expansão de URL em campanhas de pesquisa sem habilitar a IA Max.
Segmentação no nível do grupo de anúncios Novo recurso Adição de suporte na IA Max para campanhas de pesquisa em listas de marca, locais e páginas da Web (regras de URL) no nível do grupo de anúncios.
ai_max_search_term_ad_combination_view Novo recurso de relatórios Informa a performance das combinações de termos de pesquisa, títulos e páginas de destino.
Segmento search_term_match_type Novo valor de tipo enumerado Adicionamos AI_MAX como uma opção de tipo de correspondência de termo de pesquisa.
Recursos
PromotionAsset Novos campos Adicionamos terms_and_conditions_text, terms_and_conditions_uri e uma das opções de promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Consulte Sobre os recursos de promoção.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Novo valor de tipo enumerado Adicionado ao AssetAutomationType para controlar a geração automatizada de texto e página de destino com base nos URLs finais das campanhas de pesquisa.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Novo serviço / método Permite remover das campanhas os recursos de expansão de URL final criados automaticamente.
ServedAssetFieldType.DESCRIPTION_PREFIX Novo valor de tipo enumerado Adicionado para corrigir um problema de geração de relatórios em que o tipo era retornado como UNKNOWN em ad_group_ad_asset_combination_view.
Campanhas
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Novo valor de tipo enumerado Retornado quando as campanhas restritas por local não têm segmentação por local (que agora gera LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN se segmentada fora da área permitida).
Integração de análise de apps de terceiros Novos campos Adição de compatibilidade com VideoCustomer.third_party_integration_partners e Campaign.third_party_integration_partners. Consulte Acompanhar conversões de apps com a análise de aplicativos de terceiros.
Campaign.advertising_partner_ids Suporte a novos campos Agora, o campo pode ser definido para campanhas atuais (permanece imutável depois de definido).
Canais negativos no nível do gerente Novo recurso Permite exclusões de listas de canais em contas de anunciantes individuais usando CustomerNegativeCriterion.
Configurações de tolerância em estratégias de ROAS desejado Novos campos Adição de suporte para TargetRoas.target_roas_tolerance_percent_millis (para estratégias de portfólio de campanhas de pesquisa) em MaximizeConversionValue e TargetRoas.
LocationInterestView Novo recurso de relatórios Resume a performance dos critérios de interesse por local do grupo de anúncios.
Conversões
Segmento conversion_attribution_event_type Novo valor de tipo enumerado Adicionamos ENGAGED_VIEW às opções de tipo de atribuição de conversão.
Geração de demanda
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Novo valor de tipo enumerado / erro Adicionado em preparação para a aplicação de orçamentos diários mínimos para campanhas Geração de demanda. Os detalhes são expostos usando budgetDailyMinimumErrorDetails.
Performance Max
campaign_search_term_view Novo recurso de relatórios Agrega métricas de termos de pesquisa no nível da campanha, permitindo a análise e a geração de relatórios de termos de pesquisa para a Performance Max.
Planejamento
ReachPlanService.ListPlannableUserInterests Novo método Permite descobrir afinidades e interesses no mercado planejáveis para generateReachForecast.
AdditionalApplicationInfo Novo campo Adicionado como uma entrada opcional em ReachPlanService.ListPlannableUserLists.
Lista de atributos do AudienceInsights Novo recurso O AudienceInsightsService.ListAudienceInsightsAttributes agora busca as listas de usuários próprias disponíveis.
Segmentação de listas de CRM por AudienceCompositionInsights Novo recurso Agora, AudienceInsightsService.GenerateAudienceCompositionInsights retorna detalhes do índice da lista de usuários para as dimensões AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST e IN_MARKET_USER_INTEREST.
TrendInsightMetrics parcela de público-alvo Novo campo Representa a parcela de um público-alvo em uma tendência.
Categorias KnowledgeGraphAttributeMetadata Novos campos Filtra atributos do Mapa de informações por categorias correspondentes.
Relatórios
Métricas de visualizações de recursos Novos recursos / métricas Adicionamos várias métricas novas a AssetGroupAsset, ChannelAggregateAssetView e CampaignAggregateAssetView. As campanhas PMax também informam valores reais para impressions.
Extensões de seletor Novo recurso Tornamos AssetSet e CampaignAssetSet pesquisáveis juntos em ChangeStatus.
search_term_targeting_status Novo segmento Segmento selecionável na visualização de termo de pesquisa da campanha.
final_url_expansion_asset_view Novo recurso de relatórios Informa detalhes da performance dos recursos de expansão de URL final.
Ajustes de valor do AssetGroup Novos campos Adição de suporte para métricas value_adjustment e all_value_adjustment no relatório AssetGroup.
landing_page_source Novo segmento Fornece um segmento de origem da página de destino em landing_page_view.
search_term_match_source Novo segmento Segmento selecionável nas visualizações de termo de pesquisa e termo de pesquisa da campanha.
match_type Novo segmento Chave de segmento selecionável na visualização de palavra-chave.
Relatórios de clusters de intenção de consulta exclusivos Novos campos Adição de clicks_unique_query_clusters, conversions_unique_query_clusters e impressions_unique_query_clusters para informar clusters de intenção de consulta únicos.
ClickType.VEHICLE_ASSETS Novo valor de tipo enumerado Acompanhe e gere relatórios de cliques relacionados especificamente aos formatos de anúncio de veículo no relatório click_view.
Análise detalhada de Lances Inteligentes
configurações de tolerância nas estratégias de pesquisa Novos campos / configurações Permite ativar a Otimização dos Lances Inteligentes em campanhas de pesquisa definindo target_roas_tolerance_percent_millis entre 10.000 (10%) e 30.000 (30%), inclusive. Para maximizar as conversões,é necessário definir target_roas. Confira nossa postagem do blog sobre a análise detalhada da Otimização dos Lances Inteligentes e o artigo da Central de Ajuda.
Compatibilidade com relatórios de diversidade Novo recurso Agora, os relatórios de diversidade agregados são compatíveis com as seguintes métricas para clusters de intenção de consulta única. Uma visualização segmentada por tempo está disponível na interface do Google Ads:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Vídeos
YouTubeVideoListAsset Novo recurso / campo Permite estabelecer vínculos entre campanhas e recursos de lista de vídeos usando Asset.youtube_video_list_asset. Consulte Usar vídeos relacionados.
Extensões de metadados de insights Novos campos Adição de novos metadados a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.
Tipos de clique interativos Novos valores de tipo enumerado Adicionados os tipos de clique: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK e PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Novo campo Permite que os anúncios em vídeo responsivos sejam veiculados como anúncios in-stream não puláveis em campanhas que misturam formatos puláveis e não puláveis.
Configurações de sequência de vídeos Novos campos Adicionamos configurações de sequenciamento somente leitura: Campaign.VideoCampaignSettings.video_ad_sequence e VideoAdSequenceStepSetting. Consulte Sobre a sequência de anúncios em vídeo.
Segmentação por lineup de vídeo Novo tipo de critério / campo Adição do tipo de critério VIDEO_LINEUP e do campo correspondente em CampaignCriterion e AdGroupCriterion. Esse recurso está disponível apenas para contas na lista de permissões.
Visualizações de posições de adequação do conteúdo Novos recursos de relatórios Adicionamos um relatório de adequação do conteúdo para os níveis de detalhes (detail_content_suitability_placement_view) e grupo (group_content_suitability_placement_view). Saiba mais em Sobre o relatório de adequação do conteúdo.

Notas de lançamento arquivadas

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