Notas da versão

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

Versões principais e secundárias da v25

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

v25.2 (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 mudanças interruptivas.

Recursos e atualizações	Tipo	Descrição
Recursos
Opções de URL para AssetGroup	Novos campos	Adicionamos suporte para opções de URL em AssetGroup, permitindo que os anunciantes especifiquem modelos de rastreamento, parâmetros personalizados e sufixos do URL final no nível do grupo de recursos: AssetGroup.tracking_url_template: modelo de URL para criar um URL de rastreamento. AssetGroup.url_custom_parameters: uma lista de mapeamentos a serem 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 adicionar parâmetros a URLs de página de destino veiculados com acompanhamento paralelo.
Campanhas
Informações sobre rastreamento automatizado de vídeos	Novos campos e enums	Adicionamos AutomatedVideoCrawlSetting a Campaign.AssetAutomationSetting, além de AssetAutomationType.AUTOMATED_VIDEO_CRAWL, para que você possa especificar as configurações de rastreamento automático de vídeo de uma campanha Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos contém uma lista de entradas AutomatedVideoCrawlInfo, cada uma configurando um rastreamento url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL ou YOUTUBE) e o status de ativação enabled.
Erros de multiplicador de valor da otimização do ciclo de vida do cliente	Novos valores de enumeração e erros	Adicionamos novos motivos de erro de validação ao configurar multiplicadores de valor (value_multiplier e high_lifetime_value_multiplier) para a otimização do ciclo de vida do cliente: 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 oferecer suporte à geração de uma campanha PMax de rascunho com base em uma campanha inteligente atual, inicializada com o status CampaignStatus.PAUSED e o status de criação CampaignCreationStatus.INCOMPLETE. Consulte Converter campanhas inteligentes em campanhas PMax: 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 definir 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	Exposição dos tipos de ação de conversão FIREBASE_ANDROID_APP_AD_IMPRESSION e FIREBASE_IOS_APP_AD_IMPRESSION, permitindo recuperar e modificar essas ações de conversão. Também expôs a categoria IN_APP_AD_REVENUE em ConversionActionCategory para rastrear a receita de monetização de anúncios no app.
Geral
BusinessProfileLocationSyncError	Novo tipo enumerado e erros	Adicionamos motivos para os erros de sincronização de local do Perfil da Empresa ao sincronizar locais em um AssetSet do tipo LOCATION_SYNC. Em vez de retornar um erro genérico UNKNOWN, a API agora retorna BusinessProfileLocationSyncError com motivos específicos (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED e NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planejamento
Métricas de percentil BenchmarksService.GenerateBenchmarksMetrics	Novos recursos	Atualizamos BenchmarksService.GenerateBenchmarksMetrics para fornecer métricas que representam a posição competitiva do cliente entre outros anunciantes no formato de nível de percentil. As métricas são retornadas em PercentileMetrics no novo campo CustomerMetrics.percentile_metrics (em GenerateBenchmarksMetricsResponse.customer_metrics e BreakdownMetrics.customer_metrics) e representadas usando BenchmarksCustomerPercentileTier. CustomerMetrics.percentile_metrics só é preenchido quando as duas condições a seguir são atendidas em GenerateBenchmarksMetricsRequest: PERCENTILE_DATA é solicitado em supplemental_data. BenchmarksSource.all_advertisers é 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 dos comparativos de mercado (average_benchmarks_metrics, como average_cpm de anúncios de "/Apparel/Clothing") não são compatíveis com trimestres em aberto e são omitidas da resposta, a menos que o date_range solicitado esteja dentro do intervalo mais restrito ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. Adicionamos um erro BenchmarksError.NO_METRICS_FOUND personalizado que indica que não foram encontradas métricas para a combinação selecionada de entradas, melhorando a usabilidade.
Identificadores de canais do YouTube para insights de criadores de conteúdo	Novo recurso	Atualizamos ContentCreatorInsightsService.GenerateCreatorInsights para permitir a pesquisa por identificadores de canais do YouTube usando YouTubeChannels.youtube_channel_handles. Os identificadores válidos precisam começar com @, como @channel_handle. Essa opção é semelhante à pesquisa por IDs de canais do YouTube. A resposta contém insights sobre os criadores de conteúdo do YouTube solicitados.
Recomendações
Recomendações de lances de CPA e ROAS	Novas recomendações	Adicionamos Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) e Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), além de ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low e ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, para aumentar o CPA desejado ou diminuir o ROAS desejado quando os lances estão muito baixos para que as campanhas de pesquisa participem dos leilões: 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 de itinerário de hotel	Novos segmentos	Adicionamos os seguintes segmentos de dimensão de itinerário de reserva de hotel e viagem ao Segments (selecionáveis com campaign, ad_group e customer): Segments.advance_booking_window: janela de reserva futura do 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 hotéis e viagens em Metrics (selecionáveis com campaign, ad_group e customer): Metrics.vertical_ads_average_booking_value_micros: taxa diária média ponderada por cliques em micros, incluindo tributos e taxas, durante o período total de estadia 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 em 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 associada à regra 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 mudanças interruptivas.

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

v25 (22/07/2026)

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

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

Alterações importantes

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

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

Recursos e atualizações	Tipo	Descrição
Anúncios
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Novo valor de tipo enumerado / comportamento	Disponível para DemandGenMultiAssetAds. Se ativada, ela gera imagens animadas usando imagens não animadas como entrada. Os novos DemandGenMultiAssetAds são ativados por padrão a partir desta versão da API.
Mutabilidade das informações de conteúdo sintético	Mudança de comportamento	Asset.synthetic_content_info e Ad.synthetic_content_info agora são totalmente mutáveis nas versões 25, 24 e 23.
Campanhas
Meta de retenção de fidelidade	Novos recursos / configurações	Adicionamos suporte à meta de retenção de fidelidade, que permite aos anunciantes otimizar campanhas para reter membros do programa de fidelidade. Adição de LOYALTY_RETENTION à enumeração 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 assinantes no formato PLA. Adicionamos Goal.loyalty_retention_goal_settings para configurar as metas 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. Adição da nova enumeração CustomerLifecycleOptimizationGoalSubType para definir os subtipos de meta aceitos. Adição de NEW_CUSTOMER_ACQUISITION à enumeração 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 à verificação da 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 enumeração 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 um gasto recente e não está qualificada) MAX_INCENTIVES_REDEEMED_FROM_OFFER (o cliente já resgatou o número máximo de incentivos desta 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 em alta	Novos campos	Agora é possível conferir mais detalhes do canal do YouTube dos vídeos relacionados ao pesquisar insights em alta. Adicionamos os novos campos channel_id, channel_name e channel_url a YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given	Novo campo	Adicionado a YouTubeChannelInsights. Isso é válido se um criador de conteúdo consentiu em compartilhar dados não públicos. Se for o caso, os seguintes campos serão preenchidos: 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	Fornece 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 de 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 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: 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 mudanças incompatíveis.

v24.2 (24/06/2026)

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

Recursos e atualizações	Tipo	Descrição
Anúncios
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Novo valor de tipo enumerado	Gera informações de texto da página de destino para serem mostradas no painel de engajamento para instâncias DemandGenVideoResponsiveAd (que são ativadas por padrão a partir desta versão da API).
Recursos
AssetGroup.google_local_services_info	Novo campo	Adicionamos suporte às informações dos Anúncios dos Serviços Locais (ID da categoria e frases de destaque) nas campanhas Performance Max.
AssetGroupSignal.local_services_id	Novo campo	Adicionado para oferecer suporte aos indicadores de ID de serviço dos Anúncios de Serviços Locais nas campanhas Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list	Novo campo	Adicionamos suporte às regras de grupo de itens de anúncios verticais para selecionar itens dos feeds verticais anexados nas campanhas Performance Max. Esse recurso está disponível apenas para contas na lista de permissões.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Novo valor de tipo enumerado / erro	Retornado ao tentar remover todos os grupos de recursos de uma campanha.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Novo valor de tipo enumerado / erro	Retornado ao tentar remover todos os indicadores de um grupo de recursos.
Campanhas
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Novos campos	Ajuda a identificar campanhas Performance Max de Serviços locais.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Novo campo	Inclui o Google Maps nos canais selecionáveis para grupos de anúncios da Geração de demanda.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Novo valor de tipo enumerado / erro	Retornado ao tentar remover todos os locais de uma campanha Performance Max de serviços locais.
SmartCampaignErrorEnum.CREATION_FAILED	Novo valor de tipo enumerado / erro	Retornado ao tentar criar campanhas inteligentes.
Conversões
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Novos valores de tipo enumerado	Representam as conversões que ocorrem quando um usuário clica em um anúncio de serviços locais e liga, envia mensagens ou faz uma reserva com o anunciante.
Experimentos
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Novos valores de tipo enumerado	Adição de suporte para novos tipos de ExperimentType: COMPARE_CAMPAIGNS: para experimentos de mix de campanhas e personalizados da Performance Max que comparam várias campanhas do mesmo tipo ou de tipos diferentes em um único experimento. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: para experimentos de otimização das campanhas Performance Max de personalização de texto e expansão de URL final.
Geral
Asset.synthetic_content_info Ad.synthetic_content_info	Novos campos	Contêm atestações para conteúdo sintético/conteúdo gerado com IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (atestações detectadas automaticamente ou fornecidas pelo sistema). Esse recurso foi portado para as versões 23 e 22. Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis. Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado: "O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo". Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completos quando a v25 for lançada.
Autorização de outra parte	Novos recursos	Beta:no momento, 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): Adição do recurso MultiPartyAuthReview e do MultiPartyAuthReviewService correspondente. Adição da enumeração MultiPartyAuthReviewStatus para rastrear o status da avaliação. 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. Adicionamos 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 volta a retornar as ofertas de incentivo padrão em vez de gerar um erro AuthenticationError.INVALID_EMAIL_ADDRESS.
Planejamento
GenerateCreatorInsightsRequest.search_topics	Novo campo	Adicionado ao serviço ContentCreatorInsightsService.GenerateCreatorInsights. Essa opção pesquisa criadores de conteúdo que falam sobre um tema no país especificado em country_locations (só é possível pesquisar em um país por vez).
CREATOR_TOPIC_INSIGHTS	Novo valor de tipo enumerado	Adicionado a InsightsKnowledgeGraphEntityCapabilities para indicar entidades na pesquisa de criadores de conteúdo que falam sobre um tema. Essas entidades precisam ser usadas no campo search_topics. Recuperado usando AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	Novo tipo / opções	Contém outras opções de pesquisa para tópicos em ListAudienceInsightsAttributes, incluindo opções para recuperar todos os tópicos compatíveis como atributos de criador de conteúdo e filtrar por recursos.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Novos campos	Entradas opcionais para os métodos ContentCreatorInsightsService. Ao fornecer esse campo, outros locais ou atributos do criador de conteúdo são preenchidos na resposta.
local_creator_insights related_local_creators	Novos campos	Preenchido quando supplemental_data contém o tipo enumerado LOCAL_CREATOR_DATA. Mostra criadores de conteúdo locais que assistiram ou estão no país escolhido e que consentiram em compartilhar dados de localização.
GenerateTrendingInsightsRequest.sub_country_locations	Novo campo	Adicionado a ContentCreatorInsightsService.GenerateTrendingInsights, permitindo pesquisas de insights em alta usando a localização do país e subpaíses.
Relatórios
PerformanceMaxPlacementView	Extensão de segmentos	Tornou-se segmentável por ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Novo campo	Se for verdadeiro, as exclusões de marca serão ignoradas nos anúncios do Shopping. Disponível apenas para campanhas do Shopping.
Segmentação
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Novo valor de tipo enumerado / erro	Retornado ao tentar segmentar um idioma que não é permitido.
Vídeos
DataLink.youtube_link_metadata	Novo campo	Contém brand_channel_id para especificar o ID do canal da marca do YouTube vinculado.

v24.1 (13/05/2026)

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

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

v24 (22/04/2026)

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

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

Alterações importantes

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

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

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

v23.3 (24/06/2026)

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

Recursos e atualizações	Tipo	Descrição
Geral
Asset.synthetic_content_info Ad.synthetic_content_info	Novos campos	Contêm declarações para conteúdo sintético/gerado por IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (declarações detectadas ou fornecidas automaticamente pelos sistemas do Google). Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis. Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado: "O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo". Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completos quando a v25 for lançada.
Aprovações de outras partes	Novos recursos	Beta:no momento, esse recurso está na versão Beta e pode mudar em versões futuras. Adicionamos suporte para análises de aprovações de várias partes (MPA): Adição do recurso MultiPartyAuthReview e do MultiPartyAuthReviewService correspondente. Adição da enumeração MultiPartyAuthReviewStatus para rastrear o status da avaliação. 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. Adicionamos 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. Versões secundárias, como v23.2, não contêm mudanças interruptivas.

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

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

v23 (28/01/2026)

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

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

Alterações importantes

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

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

Recursos e atualizações	Tipo	Descrição
Anúncios
AdFormatType	Novos valores de tipo enumerado	Adição de novos tipos de formato: TEXT, VERTICAL_ADS_BOOKING_LINK e VERTICAL_ADS_PROMOTION.
Recursos
asset_group visualização	Novos campos	Adicionamos as seguintes métricas: metrics.engagements, metrics.engagement_rate e metrics.average_cpe.
asset_group_asset visualização	Novos campos	Adicionamos as seguintes métricas: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views e metrics.interaction_event_types.
Asset.orientation	Novo campo	Campo de orientação somente leitura adicionado aos recursos de imagem e vídeo.
CampaignAsset	Novo recurso	Foi adicionado suporte para recuperar recursos de campanha com field_type definido como HEADLINE e DESCRIPTION.
ServedAssetFieldType	Novos valores de tipo enumerado	Adicionamos HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE e DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO para recursos veiculados como sitelinks.
BusinessMessageAsset	Novos recursos / suporte	Recursos de mensagem comercial atualizados: Adicionamos suporte ao Facebook Messenger e ao Zalo como provedores. Adição de FACEBOOK_MESSENGER e ZALO a BusinessMessageProvider. Adição dos campos facebook_messenger_info e zalo_info. O CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS foi adicionado ao 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 enums auxiliares para tarifas regulamentares e unidades de medida.
Campanhas
CampaignError	Novos valores de tipo enumerado / erros	Adição dos códigos de erro DURATION_TOO_LONG_FOR_TOTAL_BUDGET e END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversões
ConversionActionCategory	Novo valor de tipo enumerado	Adicionamos YOUTUBE_FOLLOW_ON_VIEWS para rastrear usuários que assistem um anúncio e depois um vídeo do mesmo canal.
Geração de demanda
DemandGenVideoResponsiveAdInfo.companion_banner	Novo campo	Adicionamos suporte a banners complementares em anúncios responsivos em vídeo da Geração de demanda.
Incentivos
Adição do suporte a incentivos "Escolha sua própria" (CYO, na sigla em inglês): Adição do método FetchIncentive para extrair incentivos personalizados disponíveis para um usuário. Adicionamos o método ApplyIncentive para aplicar um incentivo selecionado a uma conta de cliente. Adição do recurso AppliedIncentive (pode ser consultado 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ê monitore os próximos anúncios e notas da versão para esses novos códigos de erro e garanta que seus aplicativos possam gerenciar esses novos modos de falha.
Planejamento
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Novo valor de tipo enumerado	Permite criar públicos-alvo usando eventos importantes em GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport e GenerateCreatorInsights. Os eventos importantes não são compatíveis com outros métodos AudienceInsightsService, como AudienceInsightsService.GenerateAudienceOverlap e AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	Novos campos / opções	A resposta agora inclui plataformas para oferecer suporte a sugestões de taxa de conversão com base em controles de plataforma (por exemplo, Gmail, Shorts). Disponível apenas para campanhas Geração de demanda.
LanguageDistribution	Novo campo / tipo	Adicionado a YouTubeChannelInsights para fornecer detalhes sobre a distribuição de idiomas no conteúdo do canal do YouTube.
BenchmarksService	Novo serviço	Compara os dados de publicidade do YouTube com comparativos de mercado.
AudienceInsightsService.GenerateAudienceDefinition	Novo método	Traduz uma descrição de texto livre de um público-alvo em atributos correspondentes usando a IA generativa.
YouTubeChannelInsights.relevance_score	Novo campo	Avalia a relevância de um criador de conteúdo para um tema ponderado por visualizações.
TrendInsightMetrics.trend_change_percent	Novo campo	Representa a mudança percentual no valor de uma tendência durante o período de comparação.
Recomendações
GenerateRecommendationsRequest	Novo campo	is_new_customer foi adicionado. Quando definido como true para recomendações de CAMPAIGN_BUDGET, ele usa um modelo otimizado para novos clientes (recomendado apenas para clientes sem campanhas).
Relatórios
AdGroupAdAssetView	Suporte a novos recursos / métricas	Agora oferece suporte a métricas de impressão, performance e conversão para RESPONSIVE_DISPLAY_AD.
Segmento ad_sub_network_type	Novo segmento	Fornece um detalhamento granular da performance em uma rede de publicidade. Inicialmente disponível para campanhas Geração de Demanda no YouTube (in-stream, in-feed e Shorts). Precisa ser selecionada com ad_network_type.
Relatórios das campanhas Performance Max	Novo recurso	Ativamos o detalhamento do tipo de rede de publicidade para campanhas Performance Max.
UserLocationView GeographicView	Suporte para novos segmentos	Métricas de suporte segmentadas por data de conversão: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date e cross_device_conversions_value_by_conversion_date.
Segmentos de anúncios verticais	Novos segmentos	Adicionamos os seguintes segmentos: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account e vertical_ads_vertical.
PerStoreView MatchedLocationInterestView	Novos recursos de relatórios	Adicionamos PerStoreView para consultar detalhes do local da loja e MatchedLocationInterestView (para campanhas IA Max) para fornecer métricas de performance por locais geográficos de interesse.
Shopping
ShoppingPerformanceView	Suporte a novas métricas	Agora é possível usar as seguintes métricas segmentadas por data de conversão: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date e value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	Suporte a novas métricas	Adição de suporte para: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share e search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	Novo campo	Adicionado a ShoppingProduct.
Anúncios verticais
AdGroup.vertical_ads_format_setting	Novo campo	Permite controlar quais formatos de anúncio podem ser veiculados em campanhas de pesquisa usando feeds de viagem.
AdGroupCriterion SharedCriterion	Novos campos / critérios	Adicionamos o tipo de critério vertical_ads_item_group_rule_list a AdGroupCriterion e vertical_ads_item_group_rule a SharedCriterion para permitir a segmentação de grupos de itens em campanhas de pesquisa com feeds de viagem.
Integração do feed de dados de anúncios verticais	Novo recurso	Agora é possível conectar um feed de dados de anúncios verticais a uma campanha de pesquisa que usa a IA Max para mostrar anúncios de promoção de propriedade e de viagem com links para reserva ao lado de anúncios de texto. Controle os formatos com vertical_ads_format_setting e defina regras usando vertical_ads_item_group_rule. Segmentar relatórios por AdFormatType e dimensões do feed de dados de anúncios verticais.
Vídeos
AdVideoAssetInfo.ad_video_asset_feature_control	Novo campo	Adicionamos opções de controle de recursos para recursos de anúncios em vídeo.
CampaignCriterionError	Novo valor de tipo enumerado / erro	Adicionamos o código de erro INVALID_VIDEO_LINEUP_ID.
Métricas de audibilidade do YouTube	Novas métricas	Adicionamos métricas de audibilidade para anúncios em áudio no YouTube, informando se um anúncio estava audível e em quantas impressões a audibilidade pôde ser medida.

Versões principais e secundárias da v22

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

v22.2 (24/06/2026)

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

Recursos e atualizações	Tipo	Descrição
Geral
Asset.synthetic_content_info Ad.synthetic_content_info	Novos campos	Contêm declarações para conteúdo sintético/gerado por IA, divididas em advertiser_attestation (declarações fornecidas diretamente pelo anunciante) e system_attestation (declarações detectadas ou fornecidas automaticamente pelos sistemas do Google). Para ajudar você a planejar seu próximo trabalho de integração para a v25, a interface para campos de declaração de anunciante mutáveis está sendo introduzida antecipadamente para a v22 e versões mais recentes. A interface fica visível nessas versões, mas synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source permanecem imutáveis. Se você tentar uma solicitação de mutação em um desses campos, um dos seguintes erros será retornado: "O campo que tentou ser alterado é imutável" ou "Não é possível definir o campo". Esses campos vão se tornar totalmente mutáveis a partir da v25. Recomendamos usar a interface agora para criar e testar sua lógica interna. Assim, seu sistema estará pronto para recursos de gravação completos quando a v25 for lançada.
Aprovações de outras partes	Novos recursos	Beta:no momento, esse recurso está na versão Beta e pode mudar em versões futuras. Adicionamos suporte para análises de aprovações de várias partes (MPA): Adição do recurso MultiPartyAuthReview e do MultiPartyAuthReviewService correspondente. Adição da enumeração MultiPartyAuthReviewStatus para rastrear o status da avaliação. 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. Adicionamos MultiPartyAuthReviewError para erros de validação.

v22.1 (25 de fevereiro de 2026)

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

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

v22 (15 de outubro de 2025)

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

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

Alterações importantes

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

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

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

Notas de lançamento arquivadas

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