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.1 (19/08/2026)

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

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

v25 (22/07/2026)

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

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

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Campanhas
Campos independentes additional_value e additional_high_lifetime_value em CustomerLifecycleOptimizationValueSettings Parte de value_adjustment e high_lifetime_value_adjustment oneofs, respectivamente, junto com os novos campos value_multiplier e high_lifetime_value_multiplier Mudança estrutural Atualize as referências a esses campos, já que agora eles fazem parte de "oneofs".
Recursos legados CustomerLifecycleGoal e CampaignLifecycleGoal, os serviços correspondentes CustomerLifecycleGoalService e CampaignLifecycleGoalService e configurações/enumerações legadas (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Nenhum Remoção Use o esquema de metas unificadas reformulado:
Geral
Campos de tipo enumerado aninhados nas mensagens de solicitação de serviço e resposta do serviço de incentivo:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Campos de enumeração independentes: Renomeação / remoção Use os novos campos de enumeração independente em vez dos campos legados type.
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 sem animação como entrada. Os novos DemandGenMultiAssetAds são ativados por padrão a partir desta versão da API.
Mutabilidade das informações de conteúdo sintético Mudança de comportamento Asset.synthetic_content_info e Ad.synthetic_content_info agora são totalmente mutáveis nas versões 25, 24 e 23.
Campanhas
Meta de retenção de fidelidade Novos recursos / configurações Adicionamos suporte à meta de retenção de fidelidade, que permite aos anunciantes otimizar campanhas para reter membros do programa de fidelidade.
Meta de aquisição de novos clientes Novos recursos / configurações Atualizamos o suporte à meta de aquisição de novos clientes na API Google Ads para refletir o esquema de metas unificadas reformulado:
Conversões
Atribuição de conversões de terceiros do YouTube Novos campos Adicionamos suporte à verificação da atribuição de conversão do YouTube usando parceiros terceirizados: Acesse o artigo da Central de Ajuda para saber mais.
Geral
ContactDetails.phone_number_extension Novo campo Adicionado ao recurso LocalServicesLead.
IncentiveError Novos valores de tipo enumerado / erros Adicionamos novos códigos de erro específicos para falhas no resgate de incentivos:
Planejamento
Detalhes do canal do YouTube nos insights em alta Novos campos Agora é possível pesquisar insights em alta e ver mais detalhes sobre os canais do YouTube dos vídeos relacionados. Os novos campos channel_id, channel_name e channel_url foram adicionados a YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given Novo campo Adicionado a YouTubeChannelInsights. Isso é válido se um criador de conteúdo consentiu em compartilhar dados não públicos. Se for o caso, os seguintes campos serão preenchidos:
Relatórios
ad_sub_format_type Novo segmento Fornece um detalhamento dos anúncios in-stream não puláveis do YouTube por duração: Esse segmento precisa ser sempre selecionado com ad_format_type. Ele pode ser selecionado com AdGroup, AdGroupAd, Campaign, Customer, Video e VideoEnhancement.
Métricas sociais específicas de vídeo Novos campos / métricas Adicionamos métricas sociais específicas de vídeo para ajudar os anunciantes a acompanhar o engajamento do usuário (comentários, marcações "Gostei" e compartilhamentos) nos anúncios do YouTube Shorts: Eles estão disponíveis em AdGroup, AdGroupAd, Asset, Campaign, Customer e Video.

Versões principal e secundárias da v24

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

v24.2 (24/06/2026)

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

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

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

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

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

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

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

v24.1 (13/05/2026)

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

Recursos e atualizações Tipo Descrição
Anúncios
DemandGenMultiAssetAdInfo.classic_display_images Novo campo Imagens de display personalizadas enviadas e veiculadas sem exigir recursos responsivos extras.
Experimentos
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Novos valores de tipo enumerado Adição de suporte para novos tipos de ExperimentType:
  • ADOPT_AI_MAX: para experimentos que testam como a IA Max pode ajudar você a interagir com mais clientes usando a IA do Google e palavras-chave de correspondência ampla.
  • ADOPT_BROAD_MATCH_KEYWORDS: para experimentos que testam como as palavras-chave de correspondência ampla podem afetar o número de pesquisas em que seus anúncios aparecem.
  • OPTIMIZE_ASSETS: para experimentos personalizados de otimização de recursos.
  • PMAX_REPLACEMENT_SHOPPING: para experimentos que testam a performance das suas campanhas do Shopping em comparação com as campanhas Performance Max.
Experiment.video_experiment Novo campo Suporte à configuração de experimentos YOUTUBE_CUSTOM atuais que consistem em campanhas de vídeo.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Novos campos Expõe campos para oferecer suporte a testes de recursos, grupos de recursos e configurações das campanhas Performance Max nos grupos experimentais:
  • asset_testing_info: detalhes dos recursos associados às cópias experimentais de anúncios.
  • asset_groups: lista de grupos de recursos no grupo experimental para experimentos de recursos do Optimize.
  • 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 a serem usados para anúncios verticais.
user_rating, venue, event_participant_display_name Novos critérios de filtro Adição de suporte à filtragem em VerticalAdsItemGroupRuleInfo para o recurso SharedCriterion.
Métricas de experimento de controle/tratamento Novos campos Adição de valores de controle (control_clicks etc.), valores de tratamento (clicks etc.), estimativas pontuais (clicks_point_estimate etc.), margens de erro (clicks_margin_of_error etc.) e valores p (clicks_p_value etc.) em sete famílias de métricas principais (cliques, impressões, custo, conversões, custo por conversão, valor de conversão e valor de conversão por custo).
Métricas de mudança absoluta das conversões Novos campos Suporte para estimativas de diferença absoluta de Conversions usando campos de estimativa pontual, margem de erro e valor p.
Segmentação
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Novo valor de tipo enumerado / erro Retornado ao tentar excluir todas as segmentações demográficas.
Vídeos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Novo valor de tipo enumerado Publicamos a ZEFR como um parceiro de integração de visibilidade de terceiros.
DataLink.youtube_video.channel_id Novo campo Expõe o ID do canal do YouTube associado à vinculação de dados.

v24 (22/04/2026)

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

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

Alterações importantes

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

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

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

Versões principal e secundária da v23

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

v23.3 (24/06/2026)

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

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

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

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

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

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

v23.2 (25/03/2026)

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

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

v23.1 (25 de fevereiro de 2026)

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

Recursos e atualizações Tipo Descrição
Gerenciamento da conta
advertising_partner_properties.allowed_domain Novo campo Adicionado aos recursos ProductLinkInvitation e ProductLink. O parceiro de publicidade só poderá anunciar nesse domínio.
Customer.contains_eu_political_advertising Novo campo Recupera o status da declaração no nível da conta sobre se ela contém propaganda política segmentada para a UE e retorna um EuPoliticalAdvertisingStatus.
Campanhas
Campaign.text_guidelines Novo campo Adicionamos suporte para diretrizes de texto, que podem ser usadas com campanhas Performance Max e de pesquisa para controlar programaticamente recursos de texto gerados por IA. Em text_guidelines, é possível definir term_exclusions e messaging_restrictions.
CampaignPrimaryStatusReason Novos valores de tipo enumerado Adição de CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED e BOOKING_CANCELLED para fornecer os principais motivos de status das campanhas com a estratégia de lances FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Novos campos Adicionamos suporte para autodeclaração da categoria de anúncios de reserva e detalhes de reserva somente leitura.
Campaign.missing_eu_political_advertising_declaration Novo campo Permite consultar e filtrar campanhas que não têm declarações sobre se contêm publicidade política segmentada para a UE.
Conversões
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Novo valor de tipo enumerado 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 indeterminada nas dimensões demográficas.
Incentivos
IncentiveErrorEnum Novos valores de tipo enumerado / erros Dois novos códigos de erro foram adicionados: MAX_INCENTIVES_REDEEMED e ACCOUNT_TOO_OLD. Esses erros podem ser retornados para solicitações feitas a partir de 11 de março de 2026.
Planejamento
GenerateBenchmarksMetrics Novo recurso Adição de suporte para detalhamentos de data usando um BreakdownDefinition.
ReachPlanService.GenerateReachForecast Novo valor de tipo enumerado Adicionamos 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ário único Novos campos Adicionamos novas métricas que informam quantos usuários viram seu anúncio pelo menos duas, três, quatro, cinco ou dez vezes: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus e unique_users_ten_plus.
SearchTermMatchSource Novo valor de tipo enumerado Adicionamos VERTICAL_ADS_DATA_FEED para oferecer suporte a feeds de dados de anúncios verticais, como a segmentação por entidade de anúncios de viagem.
YouTubeVideoUpload
YouTubeVideoUpload Novo serviço / recurso Adicionamos o serviço YouTubeVideoUpload para permitir o envio e o gerenciamento de vídeos no YouTube, além do recurso YouTubeVideoUpload para buscar o status do envio e os metadados. Esse recurso só é compatível com REST e a biblioteca de cliente Python.

v23 (28/01/2026)

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

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

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Anúncios
Compartilhamento de anúncios permitido AdGroupAdError.AD_SHARING_NOT_ALLOWED 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 call.
Campanhas
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Renomeação / substituição Use os novos campos de data e hora para especificar componentes de tempo para campanhas. Os campos originais somente de data são removidos.
Geração de demanda
DemandGenMultiAssetAdInfo.lead_form_only Nenhum Remoção O campo lead_form_only foi removido. Atualize as referências no seu código.
Relatórios
Agrega métricas de nível de performance de recursos e tipo enumerado. Nenhum Remoção Removemos as métricas de nível de performance de recursos agregados. O tipo enumerado de nível de performance não é mais retornado para pesquisa e display.

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

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

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

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

Versões 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. Versões secundárias, como v22.2, não contêm mudanças incompatíveis.

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

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

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

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

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

v22.1 (25 de fevereiro de 2026)

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

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

v22 (15 de outubro de 2025)

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

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

Alterações importantes

Estado inicial Novo estado Tipo de alteração Diretrizes para implementação
Geração de demanda
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Correção de ortografia / renomeação Renomeie as referências para usar o nome de campo corrigido.
Geral
Sem limite de operações em AddBatchJobOperations Limite de 10.000 operações por solicitação Alteração comportamental Verifique se nenhuma solicitação AddBatchJobOperations contém mais de 10.000 operações.
Tamanho da página limitado silenciosamente a 1.000 em ListBatchJobResultsRequest Retorna o erro INVALID_PAGE_SIZE 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 foi removido.
Planejamento
views trueview_views Remoção / substituição Substitua as referências a views pelo novo campo trueview_views em ReachPlanService.
Vídeos
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Renomeações Atualize as strings de consulta e as integrações para usar os novos nomes de métricas que representam as visualizações de vídeo TrueView.

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

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

Notas de lançamento arquivadas

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