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 mais 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)	Mudança 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 na 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érios independentes de segmento vertical em AdGroupBidModifier: user_set_dates do tipo UserSetDatesInfo advance_booking_window do tipo AdvanceBookingWindowInfo length_of_booking do tipo LengthOfBookingInfo (min_days e max_days) start_day_of_week do tipo StartDayOfWeekInfo start_date_range do tipo StartDateRangeInfo	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 lance 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 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: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	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 LINE e SMS	Novos campos e valores de enumeração	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 para Serviços Locais (marcado como OBRIGATÓRIO durante a criação da campanha) e o código de erro CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Erros de validação da campanha dos Serviços Locais	Novos valores de tipo enumerado e erros	Adicionamos novos erros de validação para campanhas de Serviços Locais: CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError e CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
Validação da vinculação da conta da Central para Hotéis	Novo valor de tipo enumerado / erro	Adicionamos o código do 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 de hotel (Campaign.hotel_property_asset_set) a uma campanha Performance Max para metas de turismo requer uma vinculação ativa da conta da Central para Hotéis.
Orçamento diário mínimo da 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 mostrar o nome do recurso da configuração de medição de Lift vinculada à campanha.
Validação do teste 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	Ampliação do suporte para Campaign.listing_type em campanhas do Shopping.
Atualizações na autodeclaração de propaganda política na UE	Comportamento atualizado e novos campos	O Campaign.contains_eu_political_advertising agora é opcional para algumas campanhas que não segmentam positivamente a União Europeia. Exceto conforme indicado para campanhas DEMAND_GEN com segmentação atualizada, o campo será opcional se uma campanha atender a todas as condições a seguir após a execução da solicitação: Não contém um critério de campanha de local positivo na UE Não contém nenhum critério de campanha positivo de proximidade ou grupo por locais 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 um critério positivo de grupo de anúncios por localidade na UE Não contém critério de grupo de anúncios de proximidade positiva ou grupo por locais Contém pelo menos um critério de grupo de anúncios de local positivo que está 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 é obrigatório se este 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 vão retornar true se o campo negative do critério for false e o critério for um local na UE, uma proximidade (mesmo que se sobreponha ao território da UE) ou um grupo por locais (mesmo que se sobreponha ao território da UE).
Conversões
Configuração unificada de 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 das conversões otimizadas da conta, representada usando o novo enum EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD	Novo valor de tipo enumerado	Adicionado a 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 tipo enumerado	Adicionamos o campo LocalServicesLead.campaign ao recurso LocalServicesLead para vincular um lead à campanha associada. Adicionamos COUPON a LocalServicesLeadType para oferecer suporte a tipos de lead de cupom para Serviços Locais.
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, recursos, segmentos e métricas	Adicionamos suporte para medições de Search Lift: Adicionamos um novo recurso somente leitura SearchLiftKeywordBundle que representa um pacote de palavras-chave em um estudo de Search Lift. Adicionamos novos segmentos selecionáveis (segments.search_lift_keyword_bundle e segments.search_property) e 15 novas métricas de Search Lift (como relative_search_lift, normalized_incremental_searches, search_lift_cost_micros e search_lift_impressions) para oferecer suporte à análise de Search Lift com LiftMeasurementConfig (vinculado a campanhas usando Campaign.lift_measurement_config). Adição das enumerações SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource e SearchLiftSearchProperty.
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 a campanhas do Shopping (com ad_group selecionável como um recurso atribuído ao lado de final_url_expansion_asset_view.ad_group).
Vídeos
Divulgaçõ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. As versões secundárias, como a 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: AssetGroup.tracking_url_template: modelo de URL para criar um URL de rastreamento. AssetGroup.url_custom_parameters: uma lista de mapeamentos que serão usados para substituir tags de parâmetros personalizados de URL em tracking_url_template, final_urls ou final_mobile_urls. AssetGroup.final_url_suffix: modelo de URL para anexar parâmetros a URLs da página de destino veiculados com acompanhamento paralelo.
Campanhas
Informações sobre o rastreamento automatizado de vídeos	Novos campos e enums	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 url de rastreamento, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL ou YOUTUBE) e o status de ativação de enabled.
Erros do 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: GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
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): Defina GeneratePMaxDraftCampaignRequest.validate_only como true para validar a conversão e receber avisos de validação ou problemas de conversão em GeneratePMaxDraftCampaignResponse.validated_info sem criar a campanha de rascunho. Deixe gbp_enabled e image_enabled sem definição ou false. A definição como true ainda não é compatível e retorna SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED ou SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED. GeneratePMaxDraftCampaignResponse retorna os nomes de recursos das entidades geradas (pmax_campaign, campaign_budget, asset_group e assets) junto com validated_info.
Conversões
Impressões de anúncios do Firebase	Novos tipos e categorias de ações de conversão	Expôs os tipos de ação de conversão FIREBASE_ANDROID_APP_AD_IMPRESSION e FIREBASE_IOS_APP_AD_IMPRESSION, permitindo recuperar e modificar essas ações de conversão. Também expôs a categoria IN_APP_AD_REVENUE em ConversionActionCategory para acompanhar 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: PERCENTILE_DATA é solicitado em supplemental_data. BenchmarksSource.all_advertisers está definido em benchmarks_source (que também exige a especificação de category_filter). Adicionamos suporte a métricas de percentil para datas de trimestre em aberto em ListBenchmarksAvailableDatesResponse.supported_dates (retornadas por BenchmarksService.ListBenchmarksAvailableDates). Embora as métricas agregadas de clientes (CustomerMetrics.aggregate_metrics), de taxa de clientes (CustomerMetrics.average_rate_metrics) e de percentil de clientes (CustomerMetrics.percentile_metrics) sejam compatíveis com todas as datas em supported_dates (incluindo trimestres em aberto), as métricas de participação de clientes (CustomerMetrics.share_metrics) e de taxa da origem 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 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 estão muito baixos para que as campanhas de pesquisa participem dos leilões: RaiseTargetCpaPerformanceBidTooLowRecommendation fornece recommended_target_multiplier (um fator maior que 1.0) e current_average_target_cpa_micros. Aplique usando RaiseTargetCpaPerformanceBidTooLowParameters com target_cpa_multiplier. LowerTargetRoasPerformanceBidTooLowRecommendation fornece recommended_target_multiplier (um fator menor que 1.0) e current_average_target_roas. Aplique usando LowerTargetRoasPerformanceBidTooLowParameters com target_roas_multiplier.
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): Segments.advance_booking_window: janela de reserva futura para o itinerário em dias. Segments.length_of_booking: duração da reserva do itinerário em dias. Segments.start_date: data de início da reserva formatada como yyyy-MM-dd. Segments.start_day_of_week: dia de início da semana (DayOfWeek) da reserva. Segments.user_set_dates: indica se as datas especificadas pelo usuário foram selecionadas (HotelDateSelectionType).
Métricas de anúncios verticais	Novas métricas	Adicionamos as seguintes métricas para relatórios de anúncios de hotel e de turismo a Metrics (selecionáveis com campaign, ad_group e customer): Metrics.vertical_ads_average_booking_value_micros: tarifa diária média ponderada por cliques em micros, incluindo tributos e taxas, durante a duração da estadia total para reservas de hotel. Metrics.vertical_ads_potential_impressions: total de impressões qualificadas com limite de visualização disponíveis no contexto da consulta. Metrics.vertical_ads_price_difference_percentage: delta de porcentagem que compara o preço oferecido pelo anunciante com o menor preço concorrente da mesma propriedade.
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): Segments.vertical_ads_price_tier: nível de preço do anunciante (HotelPriceBucket) em comparação com os concorrentes no leilão. Segments.vertical_ads_rate_rule_id: o ID da regra de tarifação associado à regra de tarifação do anunciante. Segments.vertical_ads_rate_type: tipo de tarifa (HotelRateType) da reserva de hotel.

v25.1 (19/08/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v25.1. Versões secundárias, como v25.1, não contêm 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: Adicionamos novos recursos dimensionais somente leitura para resultados de estudos de Lift: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender e LiftMeasurementVideo. Adicionamos novos segmentos e métricas para oferecer suporte à análise de Brand Lift com LiftMeasurementConfig e os novos recursos dimensionais. Adicionamos as seguintes enumerações: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode e SurveySubjectType.
Medições de Conversion Lift	Novos recursos	Adicionamos suporte para medições de 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. Adicionamos o tipo enumerado ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	Novo recurso	Um novo recurso somente leitura que representa os detalhes do período de veiculação de uma configuração de medição de Lift, incluindo as datas de início e término do período de veiculação 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: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
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: Adicionamos as mensagens BrandSentimentInsight, SentimentInsightDistribution e SentimentInsightSummary. Adicionamos o tipo enumerado Sentiment. Adicionamos o valor BRAND_SENTIMENT_DATA à enumeração ContentCreatorInsightsSupplementalData. Adicionamos o valor BRAND à enumeração InsightsKnowledgeGraphEntityCapabilities.
BenchmarksService melhorias	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: Adicionamos uma opção para comparar todos os anunciantes que veiculam anúncios em uma ou mais categorias de produtos e serviços usando BenchmarksService.GenerateBenchmarksMetrics e category_filter. Mostramos mais métricas de anúncios do cliente, como o custo agregado e as visualizações, além de métricas de compartilhamento, como share_of_voice. As métricas são retornadas usando AggregateMetrics e ShareMetrics. A lista de categorias compatíveis pode ser recuperada usando BenchmarksService.ListBenchmarksSources com o tipo de origem CATEGORY.
Segmentação por status parental	Novo recurso	Adicionamos suporte para a segmentação por status parental no planejamento de alcance. Adicionamos o novo campo parental_statuses a Targeting para o serviço ReachPlanService.GenerateReachForecast e parental_statuses a PlannableTargeting para o serviço ReachPlanService.ListPlannableProducts.
Recomendações
Recommendation.campaign_specific_app_goal_recommendation	Nova recomendação	Sugere adicionar uma meta de conversão de app específica da campanha. O novo recurso EffectiveAutomaticGoal é usado para representar as metas atuais nessa recomendação.
Relatórios
Metrics.original_conversion_value	Novo campo	Representa o valor original das conversões que recebem lances. Esse é o valor não ajustado das conversões antes da aplicação de ajustes de regra de valor, como regras de valor da conversão ou metas de ciclo de vida.
Estatísticas de assinaturas 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 associação a um programa de fidelidade foi atendida para uma regra de valor da conversão.
Segmentação
vertical_ads_item_bid	Novo tipo de critério	Adicionamos o novo tipo de critério vertical_ads_item_bid a AdGroupCriterion.criterion.

v25 (22/07/2026)

Os seguintes novos recursos, atualizações e alterações interruptivas 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: Use o campo new_customer_acquisition_goal_settings no recurso Goal. Use o campo campaign_new_customer_acquisition_settings no recurso CampaignGoalConfig para configurar substituições específicas da campanha.
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: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	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	Mudança comportamental	Forneça os dois campos ao chamar ApplyIncentive.
O campo de endereço de e-mail do consumidor ContactDetails.email no recurso LocalServicesLead	Nenhum	Remoção	Remova as referências a esse campo, porque ele não é mais compatível.
Campo allowed_domain opcional em AdvertisingPartnerLinkInvitationProperties	Campo obrigatório ao chamar CreateProductLinkInvitation para um parceiro de publicidade	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	Em vez disso, 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 de tipo enumerado / comportamento	Disponível para DemandGenMultiAssetAds. Se ativada, ela gera imagens animadas usando imagens não animadas como entrada. Os novos DemandGenMultiAssetAds são ativados por padrão a partir desta versão da API.
Mutabilidade das informações de conteúdo sintético	Mudança de comportamento	Asset.synthetic_content_info e Ad.synthetic_content_info agora são totalmente mutáveis nas versões 25, 24 e 23.
Campanhas
Meta de retenção de fidelidade	Novos recursos / configurações	Adicionamos suporte à meta de retenção de fidelidade, que permite aos anunciantes otimizar campanhas para reter membros do programa de fidelidade. Adição de LOYALTY_RETENTION ao tipo enumerado GoalType. Adicionamos CampaignGoalConfig.campaign_loyalty_retention_settings para configurar as opções de retenção de fidelidade específicas da campanha, incluindo ajustes de lance e exibição de benefícios para membros no formato PLA. Adicionamos Goal.loyalty_retention_goal_settings para definir as configurações da meta de retenção de fidelidade no nível da conta. Adicionamos novos códigos de erro: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
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: Estendemos o recurso Goal para oferecer suporte às configurações de aquisição de novos clientes usando o campo new_customer_acquisition_goal_settings. Estendemos o recurso CampaignGoalConfig para oferecer suporte a substituições específicas da campanha para aquisição de novos clientes usando o campo campaign_new_customer_acquisition_settings. Adicionamos o novo tipo enumerado CustomerLifecycleOptimizationGoalSubType para definir os subtipos de meta compatíveis. Adição de NEW_CUSTOMER_ACQUISITION ao tipo enumerado GoalType. Adicionamos novos motivos de erro de validação a GoalError: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Adicionamos novos motivos de erro de validação a CampaignGoalConfigError: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Adicionamos ErrorDetails.incompatible_clo_goal_error_details para expor a nova estrutura IncompatibleCloGoalsErrorDetails para erros de validação.
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: Adicionamos CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners para permitir a configuração de parceiros de integração no nível do cliente. Adicionamos CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners para permitir a configuração de parceiros de integração no nível da campanha. Para saber mais, consulte o artigo da Central de Ajuda.
Geral
ContactDetails.phone_number_extension	Novo campo	Adicionado ao recurso LocalServicesLead.
IncentiveError	Novos valores de tipo enumerado e erros	Adicionamos novos códigos de erro específicos para falhas no resgate de incentivos: BILLING_COUNTRY_NOT_ELIGIBLE (o país de faturamento do cliente não está qualificado para o incentivo) USER_IS_MCC_MANAGER (o usuário é uma conta de administrador e não pode resgatar o incentivo) USER_SUSPENDED (a conta do cliente está suspensa) MAX_PENDING_INCENTIVES (o cliente atingiu o número máximo de incentivos pendentes) ACCOUNT_HAD_RECENT_SPEND (a conta teve gastos recentes e não está qualificada) MAX_INCENTIVES_REDEEMED_FROM_OFFER (o cliente já resgatou o número máximo de incentivos dessa oferta) MISMATCHING_BILLING_COUNTRY_CODE (o código do país de faturamento fornecido na solicitação não corresponde ao país da conta do cliente)
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: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
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: INSTREAM_NON_SKIPPABLE_STANDARD (anúncio in-stream não pulável de duração padrão) INSTREAM_NON_SKIPPABLE_MAX30_SEC (anúncio in-stream não pulável de até 30,99 segundos) INSTREAM_NON_SKIPPABLE_MAX60_SEC (anúncio in-stream não pulável com até 60,99 segundos) 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 de redes sociais específicas para vídeos, ajudando os anunciantes a acompanhar o engajamento do usuário (comentários, marcações "Gostei" e compartilhamentos) em anúncios do YouTube Shorts: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Eles estão disponíveis em AdGroup, AdGroupAd, Asset, Campaign, Customer e Video.

Versões principais e secundárias da v24

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

v24.2 (24/06/2026)

Os seguintes novos recursos e atualizações foram adicionados à API Google Ads v24.2. As versões secundárias, como a 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	Adicionado para oferecer suporte às informações dos Anúncios de Serviços Locais (ID da categoria e frases de destaque) em 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	Adicionada para oferecer suporte às 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	Identificar campanhas Performance Max para 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 atestações para conteúdo sintético/conteúdo gerado com IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (atestações detectadas automaticamente ou fornecidas pelo sistema). Esse recurso foi 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 campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis. Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado: "O campo que tentou ser modificado é 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 várias partes	Novos recursos	Beta:esse recurso está na versão Beta e pode mudar em versões futuras. Adicionamos suporte para análises de autorização de várias partes (MPA, na sigla em inglês): Adicionamos o recurso MultiPartyAuthReview e o MultiPartyAuthReviewService correspondente. Adicionamos o tipo enumerado MultiPartyAuthReviewStatus para acompanhar o status da análise. Adicionamos CustomerUserAccess.pending_multi_party_auth_review para vincular a uma avaliação pendente. Adicionamos MutateCustomerUserAccessResult.multi_party_auth_review e MutateCustomerUserAccessInvitationResult.multi_party_auth_review para retornar o nome do recurso de avaliação associado. Adição de MultiPartyAuthReviewError para erros de validação. 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 retorna 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 que pesquisam criadores de conteúdo que falam sobre um tema. Essas entidades precisam ser usadas no campo search_topics. Recuperado usando AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	Novo tipo / opções	Contém outras opções de pesquisa para 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 visualizados ou sediados no país escolhido que consentiram em compartilhar dados de local.
GenerateTrendingInsightsRequest.sub_country_locations	Novo campo	Adicionado ao ContentCreatorInsightsService.GenerateTrendingInsights, permitindo pesquisas de insights em alta usando a localização do país e subpaíses.
Relatórios
PerformanceMaxPlacementView	Extensão de segmentos	Tornou-se segmentável por ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Novo campo	Se for verdadeiro, as exclusões de marca serão ignoradas nos anúncios do Shopping. Compatível apenas com 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 sem a necessidade de 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 de Performance Max em grupos experimentais: asset_testing_info: detalhes dos recursos associados às cópias experimentais dos anúncios. asset_groups: lista de grupos de recursos no grupo experimental para experimentos de otimização de recursos. performance_max_experiment_arm_info: configurações para campanhas Performance Max em experimentos PMAX_REPLACEMENT_SHOPPING.
Geral
CustomerUserAccess.passkey_enabled	Novo campo	Campo somente leitura que indica se o usuário tem uma chave de acesso ativada.
Relatórios
mobile_device_platform	Novo segmento	Permite segmentar relatórios pela plataforma do dispositivo do usuário (como iOS ou Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Novo valor de tipo enumerado / erro	Retornado quando a granularidade temporal diária, por hora ou semanal solicitada não é compatível com os períodos da consulta (disponível apenas para os últimos 37 meses).
vertical_ads_listing_user_rating vertical_ads_listing_venue	Novos segmentos	Novos segmentos para 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	Adicionamos 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, valor de 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 seguintes novos recursos, atualizações e alterações interruptivas 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
Opcional videos e logo_images 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 é 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 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 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: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords e ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate 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	Segmento removido das visualizações AdGroupAsset, CampaignAsset e CustomerAsset.
Vídeos
Falha parcial permitida em ShareablePreviewService.GenerateShareablePreviews	Nenhuma falha parcial	Alteração comportamental	As solicitações vão falhar e gerar um erro se algum ID não passar na validação.
ShareablePreviewError códigos legados: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	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ção)

Recursos e atualizações	Tipo	Descrição
Anúncios
Mutabilidade de VideoResponsiveAdInfo	Mudança de comportamento	Os objetos de informações dos anúncios responsivos em vídeo agora são mutáveis.
Recursos
travel_feed_data em AssetSet	Novo campo	Adicionado para recuperar atributos de recursos do feed de viagens (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Campanhas
Campaign.view_through_conversion_optimization_enabled	Novo campo	Permite ativar a otimização de conversõ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 de público-alvo semelhante 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: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
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: Adicionamos os tipos de critério RETAIL_FILTER_BUNDLE e RETAIL_FILTER. Adição do tipo de conjunto compartilhado RETAIL_FILTER. Adicionamos o campo retail_filter_bundle a AdGroupCriterion. Adicionamos o campo retail_filter a SharedCriterion. O método RETAIL foi adicionado a ListingGroupFilterListingSource. Adicionamos a dimensão RetailFilter a AssetGroupListingGroupFilter. Adicionamos novos erros de validação relacionados em CriterionError e AssetGroupListingGroupFilterError. Esse recurso está disponível apenas para contas na lista de permissões.

Versões principal e secundária da v23

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

v23.3 (24/06/2026)

Os novos recursos e atualizações a seguir 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 dos seguintes erros será retornado: "O campo que tentou ser modificado é imutável" ou "Não é possível definir o campo". Esses campos serão 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 outras partes	Novos recursos	Beta:esse recurso está na versão Beta e pode mudar em versões futuras. Adicionamos suporte para análises de aprovações de outra parte (MPA, na sigla em inglês): Adicionamos o recurso MultiPartyAuthReview e o MultiPartyAuthReviewService correspondente. Adicionamos o tipo enumerado MultiPartyAuthReviewStatus para acompanhar o status da análise. Adicionamos CustomerUserAccess.pending_multi_party_auth_review para vincular a uma revisão pendente. Adicionamos MutateCustomerUserAccessResult.multi_party_auth_review e MutateCustomerUserAccessInvitationResult.multi_party_auth_review para retornar o nome do recurso de avaliação associado. Adição de MultiPartyAuthReviewError para erros de validação.

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 a 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	Foi adicionado suporte para recuperar CustomerAsset com field_type definido como BUSINESS_LOGO.
Campanhas
AdGroupAd.start_date_time AdGroupAd.end_date_time	Novos campos	Forneça restrições de programação mais 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	Adição 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/02/2026)

Os novos recursos e atualizações a seguir foram adicionados à API Google Ads v23.1. As versões secundárias, como 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	Adição 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 de forma programática os recursos de texto gerados com 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 à autodeclaração da categoria de anúncios de reserva e aos 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 GOOGLE_DISPLAY_NETWORK como uma plataforma segmentável para as conversões máximas da Geração de Demanda.
GenerateTrendingInsights	Novos campos	Adicionamos informações de linha de tendência histórica em TrendInsightDataPoint para TrendInsights ao pesquisar por tema.
Relatórios
Métricas de frequência de usuários únicos	Novos campos	Adicionamos novas métricas que informam quantos usuários viram seu anúncio pelo menos duas, três, quatro, cinco ou dez vezes: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus e unique_users_ten_plus.
SearchTermMatchSource	Novo valor de tipo enumerado	Adicionamos VERTICAL_ADS_DATA_FEED para oferecer suporte a feeds de dados de anúncios verticais, como a segmentação por entidade de anúncios de viagem.
YouTubeVideoUpload
YouTubeVideoUpload	Novo serviço / recurso	Adicionamos o serviço YouTubeVideoUpload para 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 Python.

v23 (28/01/2026)

Os seguintes novos recursos, atualizações e alterações interruptivas foram adicionados à API Google Ads v23, 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
O compartilhamento de anúncios é permitido	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Mudança 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 os componentes de tempo das 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	As métricas agregadas de rótulo de performance do recurso foram removidas. O tipo enumerado do rótulo de performance não é mais retornado para Pesquisa e Display.

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

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: Adicionamos suporte ao Facebook Messenger e ao Zalo como provedores. FACEBOOK_MESSENGER e ZALO foram adicionados a BusinessMessageProvider. Adicionamos os campos facebook_messenger_info e zalo_info. Adicionamos CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS a AssetError.
Faturamento
InvoiceService.ListInvoices	Novas opções	Agora é possível retornar detalhes mais granulares em Invoice, incluindo detalhamento de custos no nível da campanha, custos regulatórios detalhados e informações de ajuste, definindo include_granular_level_invoice_details em ListInvoicesRequest.
RegulatoryFeeType UnitOfMeasure	Novos enums	Adicionamos 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 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
Adicionamos suporte para incentivos de escolha própria (CYO, na sigla em inglês): Adição do método FetchIncentive para recuperar incentivos personalizados disponíveis para um usuário. Adição do método ApplyIncentive para aplicar um incentivo selecionado a uma conta de cliente. Adicionamos o recurso AppliedIncentive (consultável usando Search e SearchStream) para fornecer detalhes de resgate. Adicionamos novos códigos de erro em IncentiveError e AuthenticationError.INVALID_EMAIL_ADDRESS. 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ê acompanhe os próximos comunicados e notas da versão sobre esses novos códigos de erro para garantir 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 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 correspondentes usando a IA generativa.
YouTubeChannelInsights.relevance_score	Novo campo	Avalia a relevância de um criador de conteúdo para um tema ponderado por visualizações.
TrendInsightMetrics.trend_change_percent	Novo campo	Representa a mudança percentual no valor de uma tendência durante o período de comparação.
Recomendações
GenerateRecommendationsRequest	Novo campo	is_new_customer foi adicionado. Quando definido como true para recomendações de CAMPAIGN_BUDGET, ele usa um modelo otimizado para novos clientes (recomendado apenas para clientes sem campanhas).
Relatórios
AdGroupAdAssetView	Suporte a novos recursos / métricas	Agora aceita métricas de impressão, performance e conversão para RESPONSIVE_DISPLAY_AD.
Segmento ad_sub_network_type	Novo segmento	Oferece 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 de 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 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 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 as versões desativadas para ver as notas de lançamento arquivadas.