Notas da versão

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

Versão principal v26

A v26 da API Google Ads inclui os seguintes novos recursos, atualizações e alterações interruptivas.

v26 (14/10/2026)

Os novos recursos, atualizações e alterações interruptivas a seguir foram adicionados à v26 da API Google Ads, que é uma versão principal.

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

Alterações interruptivas

Estado inicial Novo estado Tipo de mudança Diretrizes para implementação
Campanhas
Campo opcional country_code em LocalServicesPmaxCampaignSettings Campo obrigatório durante a criação de campanhas Performance Max para Serviços Locais (LocalServicesPmaxCampaignSettings.country_code) Alteração comportamental Especifique country_code (junto com o novo listing_id obrigatório) ao criar campanhas Performance Max para Serviços Locais.
Conversões
O campo enhanced_conversions_for_leads_enabled em ConversionTrackingSetting (Customer.conversion_tracking_setting) Nenhum Remoção Use ConversionTrackingSetting.enablement_setting em Customer.conversion_tracking_setting para inspecionar a configuração de conversões otimizadas no nível da conta.
Segmentação
Campos de critérios específicos do hotel em AdGroupBidModifier:
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights e max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
 Campos de critério independentes de vertical em AdGroupBidModifier: Renomeação / remoção Atualize as referências para usar os campos de critério independentes de setor, que são compatíveis com a segmentação em setores de viagem além de hotéis (como Coisas legais para fazer). Os IDs de critério, o comportamento de segmentação e os modificadores de lances atuais permanecem os mesmos. Os valores de min_nights e max_nights são transferidos para min_days e max_days como estão.
HotelDateSelectionType e tipo de segments.user_set_dates DateSelectionType Renomear / mudar o tipo Use DateSelectionType em vez de HotelDateSelectionType
Motivos de erro específicos do hotel em CriterionError:
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 Motivos de erro independentes do setor em CriterionError: Renomear Atualize o tratamento de erros para verificar os novos motivos de erro independentes de vertical.

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

Recursos e atualizações Tipo Descrição
Recursos
Provedores de mensagens comerciais por SMS e LINE Novos campos e valores de tipo enumerado Adicionamos suporte ao LINE e ao SMS como provedores de mensagens em BusinessMessageAsset, incluindo novos campos BusinessMessageAsset.line_info e BusinessMessageAsset.sms_info, além de BusinessMessageProvider.LINE e BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY Novo valor de tipo enumerado / erro Adicionamos a AssetGroupError para indicar quando uma categoria especificada em GoogleLocalServicesInfo (AssetGroup.google_local_services_info) não é compatível com campanhas Performance Max para serviços locais.
Campanhas
Criação de campanhas Performance Max para Serviços Locais Novos recursos, campos e erros

Atualizamos PmaxCampaignSettings.local_services_enabled de OUTPUT_ONLY para IMMUTABLE, permitindo que clientes de API externos especifiquem local_services_enabled = true ao criar campanhas Performance Max para Serviços Locais.

Também adicionamos LocalServicesPmaxCampaignSettings.listing_id para expor o ID da ficha do Perfil da Empresa no Google vinculado à campanha Performance Max de Serviços Locais (marcado como OBRIGATÓRIO durante a criação da campanha Performance Max de Serviços Locais) e adicionamos o código de erro CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Erros de validação da campanha de Serviços Locais Novos valores de tipo enumerado e erros Adicionamos novos erros de validação para campanhas de Serviços Locais:
Validação da vinculação da conta da Central para Hotéis Novo valor de tipo enumerado / erro Adicionamos o código de erro CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED a CampaignError para indicar que a vinculação de um conjunto de recursos de propriedade do hotel (Campaign.hotel_property_asset_set) a uma campanha Performance Max para metas de turismo exige uma vinculação ativa da conta da Central para Hotéis.
Orçamento mínimo por dia para campanhas Geração de Demanda Novo campo Adicionamos o campo demand_gen_info.minimum_budget_per_day_micros a CurrencyConstant, que especifica o orçamento mínimo diário para campanhas Geração de Demanda nessa moeda. O valor desse campo é atualizado quando o orçamento mínimo aplicado pela API muda.
Configuração de medição de Lift para campanhas Novo campo Adicionamos Campaign.lift_measurement_config para expor o nome do recurso da configuração de medição de Lift vinculada à campanha.
Validação de testes da IA Max Novo valor de tipo enumerado / erro Adicionamos o código do erro ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED a ExperimentArmError ao tentar criar um experimento ADOPT_AI_MAX para uma campanha que já tem a IA Max ativada (ou que é ativada na mesma solicitação antes da criação do grupo experimental).
Tipo de listagem da campanha do Shopping Suporte expandido Suporte ampliado de Campaign.listing_type para campanhas do Shopping.
Atualizações na autodeclaração de propaganda política na UE Comportamento atualizado e novos campos

Agora, Campaign.contains_eu_political_advertising é opcional para algumas campanhas que não segmentam positivamente a União Europeia.

  • Exceto conforme observado para campanhas DEMAND_GEN com segmentação atualizada, o campo é opcional se uma campanha atender a todas as condições a seguir após a execução da solicitação:
    • Não contém nenhum critério de campanha de local positivo que esteja na UE
    • Não contém um critério de campanha de grupos por locais ou proximidade positiva
    • Contém pelo menos um critério de campanha por local positivo fora da UE
  • Para campanhas DEMAND_GEN com upgraded_targeting, o campo é opcional se todos os grupos de anúncios ativos na campanha atenderem a todas as condições a seguir após a execução da solicitação:
    • Não contém nenhum critério de grupo de anúncios de local positivo que esteja na UE
    • Não contém critérios de proximidade positiva ou de grupos por locais para grupos de anúncios
    • Contém pelo menos um critério de grupo de anúncios de local positivo fora da UE
    O campo também é opcional para campanhas sem grupos de anúncios ativos. Se uma solicitação criar um grupo de anúncios que não atenda a essas condições, AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION será retornado.
  • Essas mudanças se aplicam a campanhas novas e atuais. Em alguns casos, uma nova campanha só pode ser criada se os critérios forem adicionados na mesma solicitação. Use GoogleAdsService.Mutate para agrupar mutações.
  • Atualizamos Campaign.missing_eu_political_advertising_declaration para corresponder às mudanças em Campaign.contains_eu_political_advertising.
  • Adicionamos GeoTargetConstant.require_eu_political_advertising_declaration para indicar se um local está dentro ou fora da UE.
  • CampaignCriterion.require_eu_political_advertising_declaration e AdGroupCriterion.require_eu_political_advertising_declaration foram adicionados. Campaign.contains_eu_political_advertising será obrigatório se esse campo for true para qualquer critério no nível da campanha (ou para qualquer critério ativo no nível do grupo de anúncios em campanhas DEMAND_GEN com segmentação atualizada). Os campos retornam true se o campo negative do critério for false e o critério for um local na UE, uma proximidade (independente de haver sobreposição com o território da UE) ou um grupo por locais (independente de haver sobreposição com o território da UE).
Conversões
Configuração unificada das conversões otimizadas Novos campos e tipo enumerado Adicionamos ConversionTrackingSetting.enablement_setting e ConversionTrackingSetting.effective_enablement_setting (em Customer.conversion_tracking_setting) para expor a configuração unificada de conversões otimizadas da conta, representada pelo novo tipo enumerado EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Novo valor de tipo enumerado Adicionada ao ConversionActionCategory para oferecer suporte a interações por mensagem ou chat que indicam interesse na oferta de um anunciante.
ConversionAttributionEventType.CLICK Novo valor de tipo enumerado Adicionado a ConversionAttributionEventType para representar conversões atribuídas a um clique no anúncio, que antes eram incluídas no valor de tipo enumerado UNKNOWN.
Geral
Atualizações de leads dos Serviços Locais Novo campo e valor de enumeração
Recomendações
Recomendação de aumento de orçamento para pesquisa Nova recomendação Adicionamos RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation e ApplyRecommendationOperation.raise_budget_performance_too_low para aumentar os orçamentos diários das campanhas de pesquisa quando eles estiverem muito baixos.
Relatórios
Medições de Search Lift Novos recursos, segmentos e métricas Adicionamos suporte para medições de Search Lift:
Visualização de recursos de expansão de URL final para campanhas do Shopping Suporte expandido Expandimos final_url_expansion_asset_view para oferecer suporte às campanhas do Shopping (com ad_group selecionável como um recurso atribuído junto com final_url_expansion_asset_view.ad_group).
Vídeos
Declarações de conteúdo generativo do YouTube Novos campos e tipo enumerado Adicionamos suporte para declarações de conteúdo generativo em uploads do YouTube. O novo campo YouTubeVideoUpload.video_content_metadata do tipo VideoContentMetadata foi adicionado a YouTubeVideoUpload, contendo configurações de divulgação em VideoContentMetadata.generative_content_disclosure do tipo YouTubeVideoUploadGenerativeContentDisclosure.

Versões principais e secundárias da v25

A v25 da API Google Ads inclui os seguintes novos recursos, atualizações e alterações interruptivas.

v25.2 (23/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 alterações 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 de URL final no nível do grupo de recursos:
Campanhas
Informações sobre rastreamento automatizado de vídeos Novos campos e tipos enumerados Adicionamos AutomatedVideoCrawlSetting a Campaign.AssetAutomationSetting, junto com AssetAutomationType.AUTOMATED_VIDEO_CRAWL, permitindo que você especifique as configurações de rastreamento de vídeo automatizado para 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 tipo enumerado 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 permitir a geração de uma campanha de rascunho Performance Max com base em uma campanha inteligente, inicializada com o status CampaignStatus.PAUSED e o status de criação CampaignCreationStatus.INCOMPLETE (consulte Converter campanhas inteligentes em campanhas Performance Max):
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 que você recupere e modifique essas ações. 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 trimestres em aberto em ListBenchmarksAvailableDatesResponse.supported_dates (retornadas por BenchmarksService.ListBenchmarksAvailableDates). Embora as métricas agregadas do cliente (CustomerMetrics.aggregate_metrics), as métricas de taxa do cliente (CustomerMetrics.average_rate_metrics) e as métricas de percentil do cliente (CustomerMetrics.percentile_metrics) sejam compatíveis com todas as datas em supported_dates (incluindo trimestres em aberto), as métricas de parcela do cliente (CustomerMetrics.share_metrics) e as métricas de taxa da origem de 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 de ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics.

Adicionamos um erro BenchmarksError.NO_METRICS_FOUND personalizado que indica que nenhuma métrica foi encontrada para a combinação de entradas selecionada, 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 forem muito baixos para que as campanhas de pesquisa participem de leilões:
Relatórios
Segmentos de dimensão do itinerário do 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 aos relatórios de anúncios da categoria 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 ao Segments (selecionáveis com campaign, ad_group e customer):

v25.1 (19/08/2026)

Os novos recursos e atualizações a seguir foram adicionados à v25.1 da API Google Ads. As versões secundárias, como a v25.1, não contêm alterações interruptivas.

Recursos e atualizações Tipo Descrição
Recursos
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Novos valores de tipo enumerado Adicionamos suporte para recursos de exoneração de responsabilidade por texto.
Campanhas
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Novos campos Acompanhe a 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 de pontuação de vencedor que dão suporte a análises estatísticas detalhadas 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 voo para uma configuração de medição de Lift, incluindo as datas de início e término do voo medido (start_date e end_date).
Geral
SmartCampaignError Novos valores de tipo enumerado Adicionamos novos códigos do 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 para insights de sentimento de marca em ContentCreatorInsightsService:
Melhorias de BenchmarksService Novos recursos Adicionamos suporte a categorias como filtros para definir o escopo de uma análise de comparativos de mercado. Também são compatíveis outras métricas essenciais para os 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 de conversão original de conversões que recebem 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 membros do programa de fidelidade Novos recursos Adicionamos suporte para segmentar estatísticas por status do programa de fidelidade do usuário e adicionamos a dimensão principal de fidelidade para regras de valor da conversão:
  • Adicionamos o segmento Segments.loyalty_membership para permitir a segmentação das métricas de relatórios pelo 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 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 novos recursos, atualizações e alterações interruptivas a seguir foram adicionados à API Google Ads v25, que é uma versão principal.

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

Alterações interruptivas

Estado inicial Novo estado Tipo de mudança 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 nas mensagens de solicitação de serviço e resposta do serviço de incentivo:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Campos de tipo enumerado independentes: Renomeação / remoção Use os novos campos de tipo enumerado independentes 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 opcional allowed_domain em AdvertisingPartnerLinkInvitationProperties Campo obrigatório ao chamar CreateProductLinkInvitation para um parceiro de publicidade Mudança comportamental Forneça o 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ções)

Recursos e atualizações Tipo Descrição
Anúncios
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Novo valor / comportamento de tipo enumerado 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 para verificação de atribuição de conversão do YouTube usando parceiros terceirizados: Consulte o artigo da Central de Ajuda para saber mais.
Geral
ContactDetails.phone_number_extension Novo campo Adicionado ao recurso LocalServicesLead.
IncentiveError Novos valores de tipo enumerado e erros Adicionamos novos códigos de erro específicos para falhas no resgate de incentivos:
Planejamento
Detalhes do canal do YouTube nos insights de tendências Novos campos Adicionamos suporte para mais detalhes do canal do YouTube de vídeos relacionados ao pesquisar insights de tendências. 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 tiver consentido em compartilhar dados não públicos. Se sim, os seguintes campos são preenchidos:
Relatórios
ad_sub_format_type Novo segmento Mostra 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 v24 da API Google Ads inclui os seguintes novos recursos, atualizações e alterações interruptivas.

v24.2 (24/06/2026)

Os novos recursos e atualizações a seguir foram adicionados à API Google Ads v24.2. Versões secundárias, como v24.2, não contêm alterações 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 de 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 uma mensagem 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 testes de Performance Max personalizados 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 declarações de conteúdo sintético/gerado com IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (declarações detectadas ou fornecidas automaticamente 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 vão permanecer imutáveis para essas versões.

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

"O campo que foi tentado mutar é 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, de modo que o sistema esteja pronto para recursos de gravação completos 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 (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 precisam ser usadas no campo search_topics. Recuperado usando AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Novo tipo / opções Contém outras opções de pesquisa para temas em ListAudienceInsightsAttributes, incluindo opções para recuperar todos os temas compatíveis como atributos do criador e filtragem por recursos.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Novos campos Entradas opcionais para os métodos ContentCreatorInsightsService. Ao fornecer esse campo, você 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 foram assistidos ou estão no país escolhido e que consentiram em compartilhar dados de local.
GenerateTrendingInsightsRequest.sub_country_locations Novo campo Adicionado a ContentCreatorInsightsService.GenerateTrendingInsights, permitindo pesquisas de insights de tendências usando o país e as regiões dele.
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 "true", 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 de 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 a v24.1, não contêm alterações 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 testes 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 do YOUTUBE_CUSTOM com 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 de 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 Suporte à filtragem em VerticalAdsItemGroupRuleInfo para o recurso SharedCriterion.
Métricas de experimentos 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 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 e valor da conversão por custo).
Métricas de mudança absoluta de conversões Novos campos Suporte para estimativas de diferença absoluta de Conversions usando os 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 Publicação da ZEFR como 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 novos recursos, atualizações e alterações interruptivas a seguir foram adicionados à API Google Ads v24, que é uma versão principal.

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

Alterações interruptivas

Estado inicial Novo estado Tipo de mudança 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 modificar 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. 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. Em vez disso, use Customer.video_brand_safety_suitability.
Conversões
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Nenhum Remoção A categoria de usuário "Inscrições em programas 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 Mudar para o uso de lineups 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 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 Os seguintes campos e tipos de plano / previsão foram removidos: Atualize as integrações de acordo.
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 nelas não for validado.
ShareablePreviewError códigos legados: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Renomeação / 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ções)

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ões de visualização (VTC, na sigla em inglês) (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 leads Novos valores de tipo enumerado Adicionamos novos tipos enumerados 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 parecidas idênticas.
Planejamento
Campos ProductCoreAttributes em ListPlannableProductsResponse Novos campos Adicionamos descrição do produto planejável, objetivo de marketing, modelo de custo e 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 para as quais as campanhas não estão sendo otimizadas) a todos os recursos correspondentes:
conversion_attribution_event_type Novo segmento Adicionado a ShoppingPerformanceView.
Shopping
Campanhas para apps no ShoppingProduct Novo recurso Campanhas para apps compatíveis com o recurso ShoppingProduct. O status e os problemas da nota não são compatíveis.
Filtragem de produtos com base em tags Novo recurso Introdução da 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 v23 da API Google Ads inclui os novos recursos, atualizações e alterações interruptivas a seguir.

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 a v23.3, não contêm alterações interruptivas.

Recursos e atualizações Tipo Descrição
Geral
Asset.synthetic_content_info
Ad.synthetic_content_info		 Novos campos Contêm declarações de conteúdo sintético/gerado com 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 para essas versões.

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

"O campo que foi tentado mutar é 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, de modo que o sistema esteja 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 outra parte (MPA, na sigla em inglês):

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 alterações interruptivas.

Recursos e atualizações Tipo Descrição
Recursos
VideoEnhancement Novo recurso Contém informações específicas sobre a melhoria do anúncio em vídeo, como se ele foi gerado pelo Google ou fornecido 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 Adicionamos 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 granulares para as 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 desativada.
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. No momento, os dois campos são preenchidos.
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 a estratégia de lances Maximizar 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 Estendido para oferecer suporte às prévias do YouTube ao vivo definindo preview_type como YOUTUBE_LIVE_PREVIEW. Adição de UNSUPPORTED_AD_TYPE e TOO_MANY_RESOURCES_IN_REQUEST 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 a v23.1, não contêm alterações 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 propaganda política direcionada à UE.
Conversões
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Novo valor de tipo enumerado Permite acompanhar os 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 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 estratégia de lances Maximizar conversões da Geração de demanda.
GenerateTrendingInsights Novos campos Adicionamos informações de linha de tendência histórica em TrendInsightDataPoint a 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 oferecer suporte ao envio e 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 do Python.

v23 (28/01/2026)

Os novos recursos, atualizações e alterações interruptivas a seguir foram adicionados à v23 da API Google Ads, que é uma versão principal.

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

Alterações interruptivas

Estado inicial Novo estado Tipo de mudança Diretrizes para implementação
Anúncios
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 chamada.
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
Métricas e tipo enumerado de nível de performance de recursos agregados Nenhum Remoção As métricas agregadas de rótulo de performance do recurso foram removidas. 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
Visualização de asset_group Novos campos Adicionamos as seguintes métricas: metrics.engagements, metrics.engagement_rate e metrics.average_cpe.
Visualização de asset_group_asset 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		 Novos tipos enumerados Adicionamos tipos enumerados auxiliares para tarifas regulamentares e unidades de medida.
Campanhas
CampaignError Novos valores de tipo enumerado / erros Adicionamos 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 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 de escolha própria (CYO):

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 avisos e notas da versão para esses novos códigos do 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 sugestões de taxa de conversão com base nos 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 de distribuição de idiomas no conteúdo do canal do YouTube.
BenchmarksService Novo serviço Compara os dados de publicidade no YouTube com os comparativos de mercado.
AudienceInsightsService.GenerateAudienceDefinition Novo método Traduz uma descrição de texto livre de um público-alvo em atributos de público-alvo correspondentes usando 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 junto com ad_network_type.
Relatórios de 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 da localização da loja e MatchedLocationInterestView (para campanhas IA Max) para fornecer métricas de performance por localizações geográficas de interesse.
Shopping
ShoppingPerformanceView Suporte a novas métricas Agora aceita 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 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 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, que informam se um anúncio era audível e em quantas impressões a audibilidade pôde ser medida.

Notas de lançamento arquivadas

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