Notas de la versión

Consulta Bajas de funciones para obtener una lista actualizada de las bajas de funciones actuales y planificadas.

Versiones principales y secundarias de v24

La versión 24 de la API de Google Ads incluye las siguientes funciones, actualizaciones y cambios disruptivos nuevos.

v24.2 (24/6/2026)

En la versión 24.2 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v24.2, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Anuncios
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Valor de enum nuevo Genera información de texto de la página de destino para que se muestre en el panel de participación de las instancias de DemandGenVideoResponsiveAd (que están habilitadas de forma predeterminada a partir de esta versión de la API).
Recursos
AssetGroup.google_local_services_info Nuevo campo Se agregó compatibilidad con la información de los anuncios de Servicios locales (ID de categoría y textos destacados) en las campañas de máximo rendimiento.
AssetGroupSignal.local_services_id Nuevo campo Se agregó compatibilidad con los indicadores de ID de servicio de los Anuncios de Servicios Locales en las campañas de máximo rendimiento.
AssetGroupSignal.vertical_ads_item_group_rule_list Nuevo campo Se agregó compatibilidad con las reglas de grupos de artículos de anuncios verticales para seleccionar artículos de los feeds verticales adjuntos en las campañas de máximo rendimiento. Esta función solo está disponible para las cuentas incluidas en la lista de entidades permitidas.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Nuevo valor o error de enum Se devuelve cuando se intenta quitar todos los grupos de recursos de una campaña.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nuevo valor o error de enum Se devuelve cuando se intenta quitar todos los indicadores de un grupo de recursos.
Campañas
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Campos nuevos Ayuda a identificar las campañas de máximo rendimiento de Servicios Locales.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Nuevo campo Incluye Google Maps en los canales seleccionables para los grupos de anuncios de generación de demanda.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Nuevo valor o error de enum Se devuelve cuando se intenta quitar todas las ubicaciones de una campaña de máximo rendimiento de Servicios Locales.
SmartCampaignErrorEnum.CREATION_FAILED Nuevo valor o error de enum Se devuelve cuando se intenta crear campañas inteligentes nuevas.
Conversiones
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Nuevos valores de enumeración Representan las conversiones que se producen cuando un usuario hace clic en un anuncio de Servicios locales y llama, envía un mensaje o reserva los servicios del anunciante.
Experimentos
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Nuevos valores de enumeración Se agregó compatibilidad con los nuevos tipos de ExperimentType:
  • COMPARE_CAMPAIGNS: Para experimentos de combinación de campañas y experimentos personalizados de campañas de máximo rendimiento que comparan varias campañas del mismo tipo o de diferentes tipos en un solo experimento.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: Para los experimentos de optimización de las campañas de máximo rendimiento para la personalización de texto y la expansión de la URL final
General
Asset.synthetic_content_info
Ad.synthetic_content_info		 Campos nuevos Contienen certificaciones para el contenido sintético o generado por IA, divididas en advertiser_input (declaraciones proporcionadas directamente por el anunciante) y system_input (certificaciones detectadas automáticamente o proporcionadas por el sistema).

Esta función se incorporó a las versiones 23 y 22.

Para ayudarte a planificar tu próximo trabajo de integración para la versión 25, se presenta anticipadamente la interfaz para mutar los campos de certificación del anunciante para la versión 22 y versiones posteriores. La interfaz es visible en estas versiones, pero synthetic_content_info.advertiser_attestation.status y synthetic_content_info.advertiser_attestation.source seguirán siendo inmutables para estas versiones.

Si intentas realizar una solicitud de mutación en cualquiera de estos campos, se devolverá uno de los siguientes errores:

"El campo que se intentó modificar es inmutable" o "No se puede establecer el campo".

Estos campos serán completamente mutables a partir de la versión 25. Te recomendamos que uses la interfaz ahora para compilar y probar tu lógica interna, de modo que tu sistema esté listo para las capacidades de escritura completas cuando se lance la versión 25.
Autorización de varias partes Nuevas funciones Se agregó compatibilidad con las revisiones de autorización de varias partes (MPA):
Esta función se portó a versiones anteriores de v23.3, v22.2 y v21.2.
IncentiveService.FetchIncentive Cambio de comportamiento Cuando se proporciona una dirección de correo electrónico no válida en la solicitud, el método ahora recurre correctamente a mostrar las ofertas de incentivos predeterminadas en lugar de arrojar un error AuthenticationError.INVALID_EMAIL_ADDRESS.
Planificación
GenerateCreatorInsightsRequest.search_topics Nuevo campo Se agregó al servicio ContentCreatorInsightsService.GenerateCreatorInsights. Esta opción busca a los creadores que hablan sobre un tema en el país especificado en country_locations (solo admite la búsqueda en un país).
CREATOR_TOPIC_INSIGHTS Valor de enum nuevo Se agregó a InsightsKnowledgeGraphEntityCapabilities para indicar entidades para buscar creadores que hablan sobre un tema. Estas entidades se deben usar en el campo search_topics. Se recuperó con AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Nuevo tipo o nuevas opciones Contiene opciones de búsqueda adicionales para los temas en ListAudienceInsightsAttributes, incluidas las opciones para recuperar todos los temas admitidos como atributos de creador y filtrar por capacidades.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Campos nuevos Son entradas opcionales para los métodos ContentCreatorInsightsService. Si se proporciona este campo, se propagan ubicaciones adicionales o atributos del creador en la respuesta.
local_creator_insights
related_local_creators		 Campos nuevos Se propaga cuando supplemental_data contiene la enumeración LOCAL_CREATOR_DATA. Muestra a los creadores locales que se vieron en el país elegido o que residen en él y que dieron su consentimiento para compartir datos de ubicación.
GenerateTrendingInsightsRequest.sub_country_locations Nuevo campo Se agregó a ContentCreatorInsightsService.GenerateTrendingInsights, lo que permite buscar estadísticas de tendencias por ubicación del país y sububicaciones del país.
Informes
PerformanceMaxPlacementView Extensión de segmentos ad_network_type hizo que se pudiera segmentar.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nuevo campo Si es verdadero, se ignoran las exclusiones de marca para los anuncios de Shopping. Solo se admite para las campañas de Shopping.
Segmentación
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nuevo valor o error de enum Se devuelve cuando se intenta segmentar por un idioma que no está permitido.
Videos
DataLink.youtube_link_metadata Nuevo campo Contiene brand_channel_id para especificar el ID del canal de marca de YouTube vinculado.

v24.1 (13/5/2026)

En la versión 24.1 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v24.1, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Anuncios
DemandGenMultiAssetAdInfo.classic_display_images Nuevo campo Imágenes de pantalla personalizadas subidas que se publican sin necesidad de recursos responsivos adicionales.
Experimentos
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Nuevos valores de enumeración Se agregó compatibilidad con los nuevos tipos de ExperimentType:
  • ADOPT_AI_MAX: Para experimentos que prueban cómo IA Max puede ayudarte a atraer a más clientes con la IA de Google y las palabras clave de concordancia amplia.
  • ADOPT_BROAD_MATCH_KEYWORDS: Para experimentos que prueban cómo las palabras clave de concordancia amplia pueden afectar la cantidad de búsquedas en las que aparecen tus anuncios
  • OPTIMIZE_ASSETS: Para experimentos personalizados para optimizar recursos.
  • PMAX_REPLACEMENT_SHOPPING: Para experimentos que prueban el rendimiento de tus campañas de Shopping en comparación con las campañas de máximo rendimiento.
Experiment.video_experiment Nuevo campo Se brinda asistencia para la configuración de experimentos existentes de YOUTUBE_CUSTOM que constan de campañas de video.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Campos nuevos Expone campos para admitir pruebas de recursos, grupos de recursos y parámetros de configuración de las campañas de máximo rendimiento en los grupos experimentales:
  • asset_testing_info: Son los detalles de los recursos asociados con las copias experimentales de los anuncios.
  • asset_groups: Es la lista de grupos de recursos en el grupo experimental para los experimentos de Optimize Assets.
  • performance_max_experiment_arm_info: Es la configuración de las campañas de máximo rendimiento en los experimentos de PMAX_REPLACEMENT_SHOPPING.
General
CustomerUserAccess.passkey_enabled Nuevo campo Campo de solo lectura que indica si el usuario tiene habilitada una llave de acceso.
Informes
mobile_device_platform Nuevo segmento Permite segmentar los informes según la plataforma del dispositivo del usuario (como iOS o Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Nuevo valor o error de enum Se devuelve cuando no se admite la granularidad temporal diaria, por hora o semanal solicitada para los períodos de la búsqueda (solo está disponible para los últimos 37 meses).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Nuevos segmentos Son segmentos nuevos que se usarán para los anuncios verticales.
user_rating, venue, event_participant_display_name Nuevos criterios de filtro Se agregó compatibilidad con el filtrado en VerticalAdsItemGroupRuleInfo para el recurso SharedCriterion.
Métricas de experimentos de control y tratamiento Campos nuevos Se agregaron valores de control (control_clicks, etc.), valores de tratamiento (clicks, etc.), estimaciones puntuales (clicks_point_estimate, etc.), márgenes de error (clicks_margin_of_error, etc.) y valores de P (clicks_p_value, etc.) en siete familias de métricas principales (clics, impresiones, costo, conversiones, costo por conversión, valor de conversión y valor de conversión por costo).
Métricas de cambio absoluto de las conversiones Campos nuevos Se agregó compatibilidad con las estimaciones de diferencia absoluta de Conversions con campos de estimación puntual, margen de error y valor p.
Segmentación
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nuevo valor o error de enum Se devuelve cuando se intenta excluir todos los objetivos demográficos.
Videos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Valor de enum nuevo Se publicó ZEFR como socio de integración de medición de visibilidad de terceros.
DataLink.youtube_video.channel_id Nuevo campo Expone el ID del canal de YouTube asociado con la vinculación de datos.

v24 (22/4/2026)

En la versión 24 de la API de Google Ads, que es una versión principal, se agregaron las siguientes funciones nuevas, actualizaciones y cambios disruptivos.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Cambios rotundos

Estado inicial Estado nuevo Tipo de cambio Asesoramiento para la implementación
Anuncios
videos y logo_images opcionales en DemandGenVideoResponsiveAdInfo Campos obligatorios Cambio de comportamiento Proporciona videos y logo_images cuando crees o modifiques anuncios de video responsivos de generación de demanda.
videos, business_name y logo_images opcionales en VideoResponsiveAdInfo Campos obligatorios Cambio de comportamiento Proporciona videos, business_name y logo_images cuando crees o modifiques anuncios de video responsivos. Ten en cuenta que VideoResponsiveAdInfo ahora es mutable.
Campañas
Campaign.video_brand_safety_suitability Ninguno Eliminación Se quitó el control de idoneidad a nivel de la campaña. La idoneidad para la seguridad de la marca sigue disponible a nivel del cliente. En su lugar, usa Customer.video_brand_safety_suitability.
Conversiones
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Ninguno Eliminación Se quitó la categoría de usuarios que se registraron en el programa de lealtad. Quita las referencias de código a él.
Planificación
Tipo InsightsAudienceAttributeGroup para topic_audience_combinations Tipo common.InsightsAudienceAttributeGroup Cambio de tipo o de comportamiento Las integraciones de bibliotecas cliente escritas deben actualizarse para usar los nuevos espacios de nombres de recursos.
Campo youtube_select_lineups en ReachPlanService.ListPlannableProducts Ninguno Eliminación Cambia a usar alineaciones de youtube_select_lineup_targeting.
Campo is_brand_connect_creator en ContentCreatorInsightsService.GenerateCreatorInsights y GenerateTrendingInsights Ninguno Eliminación En su lugar, verifica si un creador tiene CREATOR_PARTNERSHIPS disponible en partnership_opportunities.
geo_modifiers y biddable_keywords en KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants y keywords Cambio de nombre o eliminación Se reemplazó por CampaignToForecast.geo_target_constants[] y ForecastAdGroup.keywords[].
Campos obsoletos de previsión o plan de palabras clave en GenerateKeywordForecastMetrics Ninguno Eliminación Se quitaron los siguientes campos y tipos de planes y previsiones: Actualiza las integraciones según corresponda.
Informes
Segmento ad_sub_network_type en campaign_budget Ninguno Eliminación Se quitó el segmento ad_sub_network_type del recurso campaign_budget.
Segmento click_type en las vistas de recursos Ninguno Eliminación Se quitó el segmento de las vistas AdGroupAsset, CampaignAsset y CustomerAsset.
Videos
Se permite la falla parcial en ShareablePreviewService.GenerateShareablePreviews Sin falla parcial Cambio de comportamiento Las solicitudes fallarán y mostrarán un error si algún ID dentro de ellas no pasa la validación.
Códigos heredados de ShareablePreviewError: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Cambio de nombre o comportamiento Se modificaron los códigos de error que se muestran para los grupos de recursos de modo que se alineen con los errores de los anuncios de los grupos de anuncios. Se actualizó la lógica de captura de validación.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
Anuncios
Mutabilidad de VideoResponsiveAdInfo Cambio de comportamiento Los objetos de información de los anuncios de video responsivos ahora son mutables.
Recursos
travel_feed_data en AssetSet Nuevo campo Se agregó para recuperar atributos de recursos del feed de viajes (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Campañas
Campaign.view_through_conversion_optimization_enabled Nuevo campo Permite habilitar la optimización de conversiones posimpresión (VTC) (false predeterminado) en las campañas de generación de demanda y de aplicaciones.
CampaignCriterion.gender Función nueva Se habilitaron las exclusiones por género para las campañas de máximo rendimiento en todas las versiones de la API de Google Ads.
Conversiones
Tipos de conversiones de campañas de generación de clientes potenciales Nuevos valores de enumeración Se agregaron nuevos enums de tipos de acciones de conversión de GA4/Firebase en 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
General
UserListErrorEnum.DUPLICATE_LOOKALIKE Nuevo valor o error de enum Se devuelve cuando se intenta crear varias listas de público similar idénticas.
Planificación
Campos ProductCoreAttributes en ListPlannableProductsResponse Campos nuevos Se agregaron la descripción del producto planificable, el objetivo de marketing, el modelo de costos y el método de compra a ProductCoreAttributes en ListPlannableProductsResponse.
Informes
CartDataSalesView Nuevo recurso de informes Expone informes que segmentan las métricas de conversiones según el producto específico que se vendió (marca, etc.), además del producto en el que se hizo clic.
Métricas no aptas para ofertas Campos nuevos Se agregaron métricas no aptas para ofertas (métricas que muestran las conversiones para las que no se optimizan las campañas) a todos los recursos coincidentes:
conversion_attribution_event_type Nuevo segmento Agregado a ShoppingPerformanceView
Shopping
Campañas de aplicaciones en ShoppingProduct Función nueva Son las campañas de aplicaciones admitidas dentro del recurso ShoppingProduct. No se admiten los estados ni los problemas de las notas.
Filtrado de productos basado en etiquetas Función nueva Se introdujo el filtrado con expresiones de conjuntos lógicos de forma dinámica: Esta función solo está disponible para las cuentas incluidas en la lista de entidades permitidas.

Versiones principales y secundarias de v23

La versión 23 de la API de Google Ads incluye las siguientes funciones, actualizaciones y cambios disruptivos nuevos.

v23.3 (24/6/2026)

En la versión 23.3 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v23.3, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
General
Asset.synthetic_content_info
Ad.synthetic_content_info		 Campos nuevos Contienen certificaciones para el contenido sintético o generado por IA, divididas en advertiser_attestation (declaraciones proporcionadas directamente por el anunciante) y system_attestation (certificaciones detectadas automáticamente o proporcionadas por los sistemas de Google).

Para ayudarte a planificar tu próximo trabajo de integración para la versión 25, se presenta anticipadamente la interfaz para mutar los campos de certificación del anunciante para la versión 22 y versiones posteriores. La interfaz es visible en estas versiones, pero synthetic_content_info.advertiser_attestation.status y synthetic_content_info.advertiser_attestation.source permanecerán inmutables para estas versiones.

Si intentas realizar una solicitud de mutación en cualquiera de estos campos, se devolverá uno de los siguientes errores:

"El campo que se intentó modificar es inmutable" o "No se puede establecer el campo".

Estos campos serán completamente mutables a partir de la versión 25. Te recomendamos que uses la interfaz ahora para compilar y probar tu lógica interna, de modo que tu sistema esté listo para las capacidades de escritura completas cuando se lance la versión 25.
Aprobaciones de varias partes Nuevas funciones Se agregó compatibilidad con las revisiones de aprobaciones de varias partes (MPA):

v23.2 (25/3/2026)

En la versión 23.2 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v23.2, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Recursos
VideoEnhancement Recurso nuevo Contiene información específica de la mejora del anuncio de video, como si es generado por Google o proporcionado por el anunciante. Consulta Acerca de las mejoras de video para obtener más información.
AppTopCombinationView Recurso nuevo Es un recurso de solo lectura que proporciona estadísticas sobre las combinaciones de recursos con mejor rendimiento en las campañas de aplicaciones.
CustomerAsset Función nueva Se agregó compatibilidad para recuperar CustomerAsset con field_type establecido en BUSINESS_LOGO.
Campañas
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Campos nuevos Proporciona restricciones de programación más detalladas sobre las fechas de la campaña. Esta opción solo se admite para algunos tipos de grupos de anuncios.
HotelSettingInfo.disable_hotel_setting Nuevo campo Permite inhabilitar el feed de hoteles en las campañas de generación de demanda.
General
CustomerClientLinkError Nuevos valores o errores de enumeración Se agregaron dos códigos de error nuevos: MAX_CUSTOMER_LIMIT_REACHED y ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Cambio de comportamiento Ahora se arroja un error cuando se intenta usar esta categoría de tipo de cliente de la lista de usuarios que dejó de estar disponible.
Planificación
GenerateTrendingInsights
GenerateCreatorInsights		 Nuevas funciones Se agregó compatibilidad con combinaciones personalizadas de Y/O de entidades, temas y públicos.
ReachPlanService.GenerateReachForecast Nuevos valores de enumeración Se agregaron nuevos rangos de edad para la segmentación, como AGE_RANGE_21_44 o AGE_RANGE_21_49.
youtube_select_lineup_targeting Nuevo campo Se agregó a ReachPlanService.ListPlannableProducts, que reemplazará a youtube_select_lineups. Actualmente, ambos campos están propagados.
ReachPlanSurface Valor de enum nuevo Se agregó IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS como opción de plataforma.
Forecast Nuevo campo Se agregó clicks para las campañas de generación de demanda de Max. clics (CPC) en ReachPlanService.GenerateReachForecast.
partnership_opportunities Nuevo campo Se agregaron a ContentCreatorInsightsService.GenerateCreatorInsights y ContentCreatorInsightsService.GenerateTrendingInsights.
Informes
biddable_indirect_install_first_in_app_conversion_micros Nuevo campo Se agregó a los recursos Campaign, Customer y AdGroup.
Videos
ShareablePreviewService Función nueva Se extendió para admitir vistas previas de YouTube en vivo configurando preview_type en YOUTUBE_LIVE_PREVIEW. Se agregaron UNSUPPORTED_AD_TYPE y TOO_MANY_RESOURCES_IN_REQUEST a ShareablePreviewError. Esta opción solo está disponible para algunos tipos de anuncios.

v23.1 (25/2/2026)

En la versión 23.1 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v23.1, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Administración de la cuenta
advertising_partner_properties.allowed_domain Nuevo campo Se agregó a los recursos ProductLinkInvitation y ProductLink. El socio publicitario solo podrá publicar anuncios en este dominio.
Customer.contains_eu_political_advertising Nuevo campo Recupera el estado de la declaración a nivel de la cuenta sobre si contiene publicidad política segmentada para la UE y devuelve un EuPoliticalAdvertisingStatus.
Campañas
Campaign.text_guidelines Nuevo campo Se agregó compatibilidad con los lineamientos para texto, que se pueden usar con las campañas de máximo rendimiento y de Búsqueda para controlar de forma programática los recursos de texto generados por IA. Dentro de text_guidelines, puedes definir term_exclusions y messaging_restrictions.
CampaignPrimaryStatusReason Nuevos valores de enumeración Se agregaron CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED y BOOKING_CANCELLED para proporcionar los motivos principales del estado de las campañas con la estrategia de ofertas FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Campos nuevos Se agregó compatibilidad con la divulgación automática de la categoría de anuncios de reservación y los detalles de reservación de solo lectura.
Campaign.missing_eu_political_advertising_declaration Nuevo campo Admite consultas y filtros de campañas que no tienen declaraciones sobre si contienen publicidad política segmentada para la UE.
Conversiones
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Valor de enum nuevo Admite el seguimiento de los usuarios que miran un anuncio y, luego, miran un video del mismo canal.
General
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Nuevo valor o error de enum Se devuelve cuando se intenta segmentar solo la categoría indeterminada en las dimensiones demográficas.
Incentivos
IncentiveErrorEnum Nuevos valores o errores de enumeración Se agregaron dos códigos de error nuevos: MAX_INCENTIVES_REDEEMED y ACCOUNT_TOO_OLD. Estos errores se pueden mostrar para las solicitudes realizadas a partir del 11 de marzo de 2026.
Planificación
GenerateBenchmarksMetrics Función nueva Se agregó compatibilidad para los desgloses por fecha con un objeto BreakdownDefinition.
ReachPlanService.GenerateReachForecast Valor de enum nuevo Se agregó GOOGLE_DISPLAY_NETWORK como plataforma segmentable para las campañas de generación de demanda que utilizan la estrategia Maximizar conversiones.
GenerateTrendingInsights Campos nuevos Se agregó información histórica de la línea de tendencia en TrendInsightDataPoint a TrendInsights cuando se busca por tema.
Informes
Métricas de frecuencia de usuarios únicos Campos nuevos Se agregaron métricas nuevas que informan cuántos usuarios vieron tu anuncio al menos dos, tres, cuatro, cinco o diez veces: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus y unique_users_ten_plus.
SearchTermMatchSource Valor de enum nuevo Se agregó VERTICAL_ADS_DATA_FEED para admitir feeds de datos de anuncios verticales, como la segmentación por entidades de los anuncios de viajes.
YouTubeVideoUpload
YouTubeVideoUpload Servicio o recurso nuevo Se agregó el servicio YouTubeVideoUpload para admitir la carga y administración de videos en YouTube, y el recurso YouTubeVideoUpload para admitir la recuperación del estado de carga y los metadatos. Esta función solo es compatible con REST y la biblioteca cliente de Python.

v23 (28/1/2026)

En la versión 23 de la API de Google Ads, que es una versión principal, se agregaron las siguientes funciones nuevas, actualizaciones y cambios disruptivos.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Cambios rotundos

Estado inicial Estado nuevo Tipo de cambio Asesoramiento para la implementación
Anuncios
Se permite el uso compartido de anuncios AdGroupAdError.AD_SHARING_NOT_ALLOWED Cambio de comportamiento Ya no se permite el uso compartido de anuncios entre varios grupos de anuncios. Las solicitudes que intenten compartir anuncios mostrarán un error AD_SHARING_NOT_ALLOWED.
Compatibilidad con CallAd y CallAdInfo Ninguno Eliminación Se quitó la compatibilidad con los anuncios de llamada. Consulta el artículo del Centro de ayuda Acerca de los anuncios de llamada.
Campañas
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Cambio de nombre o reemplazo Usa los nuevos campos de fecha y hora para especificar los componentes de tiempo de las campañas. Se quitaron los campos originales solo con fecha.
Generación de demanda
DemandGenMultiAssetAdInfo.lead_form_only Ninguno Eliminación Se quitó el campo lead_form_only. Actualiza las referencias en tu código.
Informes
Agrega métricas y enumeraciones de etiquetas de rendimiento de activos agregadas Ninguno Eliminación Se quitaron las métricas de etiquetas de rendimiento de recursos agregados. Ya no se devuelve el enum de la etiqueta de rendimiento para la Búsqueda y Display.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
Anuncios
AdFormatType Nuevos valores de enumeración Se agregaron nuevos tipos de formato: TEXT, VERTICAL_ADS_BOOKING_LINK y VERTICAL_ADS_PROMOTION.
Recursos
Vista de asset_group Campos nuevos Se agregaron las siguientes métricas: metrics.engagements, metrics.engagement_rate y metrics.average_cpe.
Vista de asset_group_asset Campos nuevos Se agregaron las siguientes métricas: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views y metrics.interaction_event_types.
Asset.orientation Nuevo campo Se agregó un campo de orientación de solo lectura a los recursos de imagen y video.
CampaignAsset Función nueva Se agregó compatibilidad para recuperar recursos de la campaña con field_type establecido en HEADLINE y DESCRIPTION.
ServedAssetFieldType Nuevos valores de enumeración Se agregaron HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE y DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO para los recursos que se publican como vínculos a sitios.
BusinessMessageAsset Nuevas funciones y asistencia Se actualizaron los recursos de Mensajes para la empresa:
Facturación
InvoiceService.ListInvoices Nuevas opciones Ahora se pueden devolver detalles más específicos en Invoice, incluido el desglose de costos a nivel de la campaña, los costos reglamentarios detallados y la información de ajustes, si se configura include_granular_level_invoice_details en ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Nuevas enumeraciones Se agregaron enumeraciones de ayuda para las unidades de medida y las tarifas reglamentarias.
Campañas
CampaignError Nuevos valores o errores de enumeración Se agregaron los códigos de error DURATION_TOO_LONG_FOR_TOTAL_BUDGET y END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversiones
ConversionActionCategory Valor de enum nuevo Se agregó YOUTUBE_FOLLOW_ON_VIEWS para admitir el seguimiento de los usuarios que miran un anuncio y, luego, miran un video del mismo canal.
Generación de demanda
DemandGenVideoResponsiveAdInfo.companion_banner Nuevo campo Se agregó compatibilidad con los banners complementarios en los anuncios de video responsivos de las campañas de generación de demanda.
Incentivos
Se agregó compatibilidad con los incentivos de Elige tu propia opción (CYO):

Para facilitar el manejo programático más detallado de las fallas, agregaremos códigos de error adicionales a IncentivesService en versiones futuras. Te recomendamos que supervises los próximos anuncios y las notas de la versión para conocer estos nuevos códigos de error y asegurarte de que tus aplicaciones puedan administrar estos nuevos modos de falla.
Planificación
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Valor de enum nuevo Permite crear públicos con Acontecimientos en GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport y GenerateCreatorInsights.

Los eventos de vida no se admiten para otros métodos de AudienceInsightsService, como AudienceInsightsService.GenerateAudienceOverlap y AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nuevos campos o opciones La respuesta ahora incluye plataformas para admitir sugerencias del porcentaje de conversiones basadas en los controles de la plataforma (p.ej., Gmail y Shorts). Solo se admite en las campañas de generación de demanda.
LanguageDistribution Nuevo campo o tipo Se agregó a YouTubeChannelInsights para proporcionar detalles sobre la distribución de idiomas en el contenido de los canales de YouTube.
BenchmarksService Servicio nuevo Compara los datos de los anuncios de YouTube con las comparativas de la industria.
AudienceInsightsService.GenerateAudienceDefinition Nuevo método Traduce una descripción de texto libre de un público objetivo en atributos de público coincidentes con IA generativa.
YouTubeChannelInsights.relevance_score Nuevo campo Evalúa qué tan relevante es un creador para un tema ponderado por las vistas.
TrendInsightMetrics.trend_change_percent Nuevo campo Representa el cambio porcentual en el valor de una tendencia durante el período de comparación.
Recomendaciones
GenerateRecommendationsRequest Nuevo campo Se agregó is_new_customer. Cuando se configura como true para las recomendaciones de CAMPAIGN_BUDGET, se usa un modelo optimizado para los clientes nuevos (solo se recomienda para los clientes que no tienen campañas).
Informes
AdGroupAdAssetView Compatibilidad con nuevas funciones o métricas Ahora admite las métricas de impresiones, rendimiento y conversiones para RESPONSIVE_DISPLAY_AD.
Segmento ad_sub_network_type Nuevo segmento Proporciona un desglose detallado del rendimiento dentro de una red de publicidad. Inicialmente, estará disponible para las campañas de generación de demanda en YouTube (in-stream, in-feed y Shorts). Se debe seleccionar junto con ad_network_type.
Informes de las campañas de máximo rendimiento Función nueva Es el desglose del tipo de red publicitaria habilitado para las campañas de máximo rendimiento.
UserLocationView
GeographicView		 Compatibilidad con segmentos nuevos Métricas de asistencia segmentadas por fecha de conversión: 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 y cross_device_conversions_value_by_conversion_date.
Segmentos de anuncios verticales Nuevos segmentos Se agregaron los siguientes 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 y vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView		 Nuevos recursos de informes Se agregó PerStoreView para consultar detalles de la ubicación de la tienda y MatchedLocationInterestView (para las campañas de IA Max) para proporcionar métricas de rendimiento por ubicaciones geográficas de interés.
Shopping
ShoppingPerformanceView Compatibilidad con métricas nuevas Ahora admite las siguientes métricas segmentadas por fecha de conversión: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date y value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Compatibilidad con métricas nuevas Se agregó compatibilidad con search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share y search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri Nuevo campo Agregado a ShoppingProduct
Anuncios verticales
AdGroup.vertical_ads_format_setting Nuevo campo Permite controlar qué formatos de anuncios se pueden publicar en las campañas de Búsqueda que utilizan feeds de viajes.
AdGroupCriterion
SharedCriterion		 Nuevos campos o criterios Se agregó el tipo de criterio vertical_ads_item_group_rule_list a AdGroupCriterion y vertical_ads_item_group_rule a SharedCriterion para permitir la segmentación de grupos de elementos en las campañas de Búsqueda con feeds de viajes.
Integración del feed de datos de anuncios verticales Función nueva Ahora puedes conectar un feed de datos de anuncios verticales a una campaña de Búsqueda que ejecute IA Max para mostrar anuncios de promoción de la propiedad y de vínculo para reservar junto con anuncios de texto. Controla los formatos con vertical_ads_format_setting y define reglas con vertical_ads_item_group_rule. Segmenta los informes por AdFormatType y dimensiones del feed de datos de anuncios verticales.
Videos
AdVideoAssetInfo.ad_video_asset_feature_control Nuevo campo Se agregaron opciones de control de funciones para los recursos de anuncios de video.
CampaignCriterionError Nuevo valor o error de enum Se agregó el código de error INVALID_VIDEO_LINEUP_ID.
Métricas de audibilidad de YouTube Métricas nuevas Se agregaron métricas de audibilidad para los anuncios de audio en YouTube, que indican si un anuncio se pudo escuchar y en cuántas impresiones se pudo medir la audibilidad.

Versiones principales y secundarias de v22

La versión 22 de la API de Google Ads incluye las siguientes funciones nuevas, actualizaciones y cambios disruptivos.

v22.2 (24/6/2026)

En la versión 22.2 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v22.2, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
General
Asset.synthetic_content_info
Ad.synthetic_content_info		 Campos nuevos Contienen certificaciones para el contenido sintético o generado por IA, divididas en advertiser_attestation (declaraciones proporcionadas directamente por el anunciante) y system_attestation (certificaciones detectadas automáticamente o proporcionadas por los sistemas de Google).

Para ayudarte a planificar tu próximo trabajo de integración para la versión 25, se presenta anticipadamente la interfaz para mutar los campos de certificación del anunciante para la versión 22 y versiones posteriores. La interfaz es visible en estas versiones, pero synthetic_content_info.advertiser_attestation.status y synthetic_content_info.advertiser_attestation.source permanecerán inmutables para estas versiones.

Si intentas realizar una solicitud de mutación en cualquiera de estos campos, se devolverá uno de los siguientes errores:

"El campo que se intentó modificar es inmutable" o "No se puede establecer el campo".

Estos campos serán completamente mutables a partir de la versión 25. Te recomendamos que uses la interfaz ahora para compilar y probar tu lógica interna, de modo que tu sistema esté listo para las capacidades de escritura completas cuando se lance la versión 25.
Aprobaciones de varias partes Nuevas funciones Se agregó compatibilidad con las revisiones de aprobaciones de varias partes (MPA):

v22.1 (25/2/2026)

Se agregó la siguiente función nueva en la versión 22.1 de la API de Google Ads. Las versiones secundarias, como la v22.1, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Administración de la cuenta
Customer.contains_eu_political_advertising Nuevo campo Recupera el estado de la declaración a nivel de la cuenta sobre si contiene publicidad política segmentada para la UE y devuelve un EuPoliticalAdvertisingStatus.
Campañas
Campaign.missing_eu_political_advertising_declaration Nuevo campo Admite consultas y filtros de campañas que no tienen declaraciones sobre si contienen publicidad política segmentada para la UE.

v22 (2025-10-15)

En la versión 22 de la API de Google Ads, que es una versión principal, se agregaron las siguientes funciones nuevas, actualizaciones y cambios breaking.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Cambios rotundos

Estado inicial Estado nuevo Tipo de cambio Asesoramiento para la implementación
Generación de demanda
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Cambio de nombre o corrección ortográfica Cambia el nombre de las referencias para usar el nombre de campo corregido.
General
No hay límite de operaciones en AddBatchJobOperations Límite de 10,000 operaciones por solicitud Cambio de comportamiento Asegúrate de que ninguna solicitud de AddBatchJobOperations contenga más de 10,000 operaciones.
El tamaño de la página se limitó de forma silenciosa a 1,000 en ListBatchJobResultsRequest Devuelve un error INVALID_PAGE_SIZE Cambio de comportamiento Asegúrate de que ListBatchJobResultsRequest.page_size esté configurado en 1,000 o menos, ya que solicitar un tamaño de página más grande ahora generará un error.
Máximo rendimiento
Etiquetas de rendimiento de los activos Ninguno Eliminación Se quitaron la compatibilidad con las etiquetas de rendimiento de los recursos y la enumeración de etiquetas de rendimiento asociada para las campañas de máximo rendimiento. Actualiza las integraciones según corresponda.
Campaign.url_expansion_opt_out La marca FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION en AssetAutomationSetting Retiro o reemplazo Utiliza el parámetro de configuración de automatización de recursos de texto de expansión de la URL final. Se quitó el campo de inhabilitación de la expansión de URL a nivel de la campaña.
Planificación
views trueview_views Retiro o reemplazo Reemplaza las referencias a views por el nuevo campo trueview_views en ReachPlanService.
Videos
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		 Cambios de nombre Actualiza las cadenas de consulta y las integraciones para usar los nuevos nombres de métricas que representan las vistas de video de TrueView.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
Recursos
AssetFieldType.LANDING_PAGE_PREVIEW Valor de enum nuevo Se agregó como un nuevo tipo de campo de recurso de imagen.
AssetGenerationService Nuevo servicio (beta) Permite generar recursos de texto y de imagen con IA generativa:
  • GenerateText: Genera texto basado en la URL final, las instrucciones, las palabras clave, etcétera.
  • GenerateImages: Genera imágenes basadas en la URL final, las instrucciones o las imágenes de productos recontextualizadas.
  • Los errores se muestran con códigos de AssetGenerationError.
Inicialmente, solo estará disponible para un conjunto limitado de participantes de la versión beta cerrada.
Campañas
AppCampaignBiddingStrategyGoalType Nuevos valores de enumeración Se agregaron nuevos objetivos para las campañas para instalación de aplicación (ACi) que permiten realizar optimizaciones sin especificar un objetivo:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Se usa con la estrategia estándar de Maximizar conversiones.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Se usa con la estrategia estándar Maximizar valor de conversión.
BiddingStrategyType Función nueva Se agregó compatibilidad con el tipo de estrategia de ofertas de porcentaje de publicaciones fijo.
Campaign.feed_types Nuevo campo Muestra los tipos de feeds adjuntos a una campaña. En el caso de las campañas de máximo rendimiento, puede indicar la vertical de la empresa, como MERCHANT_CENTER_FEED para el comercio minorista.
Segmentación por conjunto compartido Función nueva Se permitió adjuntar conjuntos compartidos de palabras clave negativas a campañas locales y de varios canales (para las campañas de aplicaciones).
Generación de demanda
Ofertas de CPC objetivo Función nueva Se agregó la estrategia de ofertas para maximizar los clics con el CPC objetivo: Se estableció el CPC objetivo a nivel de la campaña con Campaign.target_cpc y se anuló a nivel del grupo de anuncios con AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Valor de enum nuevo Si está habilitada para DemandGenMultiAssetAdInfo, esta opción agrega elementos de diseño y textos integrados a los recursos de imagen para crear recursos de imagen nuevos con diferentes relaciones de aspecto (habilitada de forma predeterminada).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Valor de enum nuevo Si está habilitada para DemandGenMultiAssetAdInfo, genera videos con otros recursos, como imágenes y texto, que luego se pueden usar para crear nuevas instancias de DemandGenVideoResponsiveAdInfo (habilitado de forma predeterminada).
General
Respaldo del tamaño de página ListBatchJobResultsRequest Cambio de comportamiento Si page_size no está establecido o es 0, ahora se establece de forma predeterminada en el máximo de 1,000 (anteriormente, se devolvía INVALID_PAGE_SIZE).
QuotaError Nuevo valor o error de enum Se agregó PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED para indicar cuándo se supera el límite de frecuencia de activación del perfil de pagos.
Máximo rendimiento
Configuración de la automatización de recursos Nuevos valores de enumeración Se agregaron nuevas opciones de automatización de recursos de las campañas de máximo rendimiento:
  • GENERATE_IMAGE_ENHANCEMENT: Habilita la creación automática de imágenes mejoradas (recorte automático). Habilitada de forma predeterminada.
  • GENERATE_IMAGE_EXTRACTION: Imágenes obtenidas de URLs finales. El valor predeterminado es el parámetro de configuración de la extensión de imagen dinámica de la cuenta.
Segmentos de informes de las campañas de PMax Nuevos segmentos Se agregaron nuevos segmentos exclusivos para las campañas de máximo rendimiento:
Planificación
Listas de datos de socios de CRM Valor de enum o función nuevos Se agregó THIRD_PARTY_PARTNER_DATA a las fuentes de datos del CRM, junto con los códigos de error de validación de públicos de socios (como la aceptación de las condiciones, la falta de vinculación, etcétera).
Métricas de los creadores de transmisiones en vivo Nuevo campo Se agregó YouTubeMetrics.is_active_live_stream_creator, que se muestra en las estadísticas de creadores para indicar si un creador publicó una transmisión en vivo en los últimos 90 días.
Metadatos de la fuente de CRM que se pueden planificar Mensaje nuevo Se agregó PlannableUserListMetadata dentro de PlannableUserList, que devuelve ReachPlanService.ListPlannableUserLists, para mostrar los tipos de fuentes de datos del CRM.
Compatibilidad con videos y creadores relacionados en TrendInsight Campos nuevos Se agregó compatibilidad con related_videos y related_creators en TrendInsight, y con las propiedades de visualización en video_properties y publish_date.
Mejoras en InsightsFinder Función nueva GenerateInsightsFinderReport ahora admite parental_status, income_ranges y combinaciones de segmentación más complejas con los operadores AND/OR.
Informes
Nuevos tipos de clics Nuevos valores de enumeración Se agregaron CLICK_TO_MESSAGE_THIRD_PARTY_CLICK y CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
Segmentación de AssetGroupAsset Compatibilidad con segmentos nuevos Ahora, AssetGroupAsset se puede segmentar por device, conversion_action, conversion_action_name y conversion_action_category.
RSA en AdGroupAdAssetView Compatibilidad con nuevas funciones o métricas Ahora AdGroupAdAssetView admite por completo las métricas de rendimiento y de conversiones para RESPONSIVE_SEARCH_AD (antes, solo se devolvían las impresiones).
Segmentaciones de métricas de clúster de búsquedas exploratorias Compatibilidad con segmentos nuevos Ahora, las métricas clicks_unique_query_clusters, conversions_unique_query_clusters y impressions_unique_query_clusters se pueden segmentar por campos de fecha.
TargetingExpansionView Nuevo recurso de informes Se agregó TargetingExpansionView a las métricas de informes para las expansiones en la segmentación manual, como la expansión sin palabras clave para las campañas de IA Max para Búsqueda.
Shopping
Corrección del alcance de Shopping Corrección de errores Se corrigió el alcance de las métricas de la campaña y el grupo de anuncios en el recurso ShoppingProduct.
Objetivos unificados
Objetivos de retención Función nueva Se agregó compatibilidad con los objetivos de retención de clientes para optimizar la reactivación de la participación de los clientes existentes (p.ej., con target_option y TARGET_SPECIFIC o TARGET_ALL).
Videos
Métricas de tiempo de reproducción de videos Campos nuevos Se agregaron métricas de duración del tiempo de reproducción: video_watch_time_duration_millis (duración total) y average_video_watch_time_duration_millis (duración promedio por impresión).

Versiones principales y secundarias de v21

La versión 21 de la API de Google Ads incluye las siguientes funciones nuevas, actualizaciones y cambios rotundos.

v21.2 (24/6/2026)

En la versión 21.2 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v21.2, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
General
Aprobaciones de varias partes Nuevas funciones Se agregó compatibilidad con las revisiones de aprobaciones de varias partes (MPA):

v21.1 (2026-02-25)

En la versión 21.1 de la API de Google Ads, se agregaron las siguientes funciones y actualizaciones nuevas. Las versiones secundarias, como la v21.1, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Administración de la cuenta
Customer.contains_eu_political_advertising Nuevo campo Recupera el estado de la declaración a nivel de la cuenta sobre si contiene publicidad política segmentada para la UE y devuelve un EuPoliticalAdvertisingStatusEnum.
Campañas
Campaign.missing_eu_political_advertising_declaration Nuevo campo Admite consultas y filtros de campañas que no tienen declaraciones sobre si contienen publicidad política segmentada para la UE.

v21 (6/8/2025)

En la versión 21 de la API de Google Ads, que es una versión principal, se agregaron las siguientes funciones nuevas, actualizaciones y cambios disruptivos.

Consulta Cómo actualizar a la versión más reciente para obtener orientación.

Cambios rotundos

Estado inicial Estado nuevo Tipo de cambio Asesoramiento para la implementación
Campañas
Devuelve CriterionError.INVALID_LISTING_GROUP_HIERARCHY. Devuelve CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION. Cambio en el código de error Para las solicitudes con una falla parcial habilitada, controla el nuevo código de error en lugar del código de error de la jerarquía original.
Conversiones
Acceso al modo debug_enabled en ConversionUploadService Ninguno Eliminación Se quitó el campo debug_enabled. Actualiza el código que hace referencia a él para que no establezca ni consulte este parámetro.
Cambios en la publicidad política de la UE
Autodeclaraciones opcionales de las campañas para la publicidad política de la UE Campo contains_eu_political_advertising obligatorio para las campañas nuevas Regla de validación o cambio de comportamiento Las llamadas a la API para crear campañas nuevas fallarán con un error FieldError.REQUIRED si no se configura este campo. A partir del 22 de septiembre de 2025, las campañas declaradas como CONTAINS_EU_POLITICAL_ADVERTISING ya no se publicarán en la UE.
Criterios modificables sin autodeclaración Falla en las actualizaciones con CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regla de validación o cambio de comportamiento Establece el estado de autodeclaración antes de intentar crear o actualizar los criterios de segmentación por proximidad, ubicación o grupo de ubicaciones a nivel de la campaña o del grupo de anuncios para las campañas existentes.
Experimentos sin requisitos de autodeclaración Falla en las actualizaciones con ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regla de validación o cambio de comportamiento Asegúrate de que se hayan completado las autodeclaraciones en las campañas del experimento.
Máximo rendimiento
El valor predeterminado de brand_guidelines_enabled es false. La configuración predeterminada es true. Cambio de comportamiento En el caso de las campañas de máximo rendimiento nuevas, los lineamientos de la marca están habilitados de forma predeterminada. Establece el campo de forma explícita en false si se deben inhabilitar.
Planificación
Tipo de argumento de entrada original para AudienceInsightsService.GenerateTargetingSuggestionMetrics Entrada de tipo InsightsAudience Cambio de tipo Actualiza las implementaciones para pasar el nuevo tipo de entrada que admite una combinación de intereses del usuario con un AND de OR, lo que permite obtener métricas de alcance potencial para las definiciones de públicos personalizados.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
IA Max para campañas de Búsqueda
ai_max_setting.enable_ai_max en Campaign Nuevo campo Permite que IA Max expanda la concordancia con términos de búsqueda (respetando la automatización de recursos de texto y las listas de marcas anteriores hasta que se desactive). El campo Campaign.ai_max_setting.bundling_required indica si se debe habilitar IA Max para respetar o modificar esos parámetros de configuración, y AdGroup.ai_max_ad_group_setting.disable_search_term_matching puede inhabilitar la concordancia a nivel del grupo de anuncios. Consulta Descubre un rendimiento óptimo con IA Max para campañas de Búsqueda.
CampaignError.AI_MAX_MUST_BE_ENABLED Nuevo valor o error de enum Se arroja cuando se habilita la automatización de recursos de texto de expansión de URL en las campañas de Búsqueda sin habilitar IA Max.
Segmentación a nivel del grupo de anuncios Función nueva Se agregó compatibilidad en IA Max para campañas de Búsqueda con listas de marcas, ubicaciones y páginas web (reglas de URL) a nivel del grupo de anuncios.
ai_max_search_term_ad_combination_view Nuevo recurso de informes Informa el rendimiento de las combinaciones de términos de búsqueda, títulos y páginas de destino.
Segmento search_term_match_type Valor de enum nuevo Se agregó AI_MAX como opción de tipo de concordancia del término de búsqueda.
Recursos
PromotionAsset Campos nuevos Se agregaron terms_and_conditions_text, terms_and_conditions_uri y las opciones de uno de promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Consulta Acerca de los recursos de promoción.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Valor de enum nuevo Se agregó a AssetAutomationType para controlar la generación automatizada de texto y páginas de destino a partir de las URLs finales en las campañas de Búsqueda.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Servicio o método nuevo Permite quitar de las campañas los recursos de expansión de la URL final creados automáticamente.
ServedAssetFieldType.DESCRIPTION_PREFIX Valor de enum nuevo Se agregó para corregir un problema de informes en el que el tipo se devolvía como UNKNOWN en ad_group_ad_asset_combination_view.
Campañas
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Valor de enum nuevo Se devuelve cuando las campañas restringidas por ubicación no tienen segmentación geográfica (que ahora arroja LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN si se segmentan fuera del área permitida).
Integración de estadísticas de aplicaciones de terceros Campos nuevos Se agregó compatibilidad con VideoCustomer.third_party_integration_partners y Campaign.third_party_integration_partners. Consulta Cómo hacer un seguimiento de las conversiones de aplicaciones con estadísticas de aplicaciones de terceros.
Campaign.advertising_partner_ids Compatibilidad con campos nuevos Ahora se puede configurar el campo para las campañas existentes (permanece inmutable después de configurarse).
Posiciones negativas a nivel de la cuenta de administrador Función nueva Permite excluir listas de posiciones en cuentas de anunciantes individuales con CustomerNegativeCriterion.
Configuraciones de tolerancia en las estrategias de ROAS objetivo Campos nuevos Se agregó compatibilidad con TargetRoas.target_roas_tolerance_percent_millis (para las estrategias de cartera de las campañas de búsqueda) en MaximizeConversionValue y TargetRoas.
LocationInterestView Nuevo recurso de informes Resume el rendimiento de los criterios de interés por ubicación del grupo de anuncios.
Conversiones
Segmento conversion_attribution_event_type Valor de enum nuevo Se agregó ENGAGED_VIEW a las opciones de tipo de atribución de conversiones.
Generación de demanda
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Nuevo valor o error de enum Se agregó en preparación para aplicar los presupuestos diarios mínimos en las campañas de generación de demanda. Los detalles se exponen con budgetDailyMinimumErrorDetails.
Máximo rendimiento
campaign_search_term_view Nuevo recurso de informes Agrega las métricas de los términos de búsqueda a nivel de la campaña, lo que permite el análisis y la generación de informes de los términos de búsqueda para las campañas de máximo rendimiento.
Planificación
ReachPlanService.ListPlannableUserInterests Nuevo método Permite descubrir afinidades planificables e intereses en el mercado para generateReachForecast.
AdditionalApplicationInfo Nuevo campo Se agregó como entrada opcional en ReachPlanService.ListPlannableUserLists.
Listado de atributos de AudienceInsights Función nueva AudienceInsightsService.ListAudienceInsightsAttributes ahora recupera las listas de usuarios propios disponibles.
Las estadísticas de AudienceCompositionInsights segmentan las listas de CRM Función nueva AudienceInsightsService.GenerateAudienceCompositionInsights ahora devuelve detalles del índice de la lista de usuarios para las dimensiones AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST y IN_MARKET_USER_INTEREST.
TrendInsightMetrics porcentaje de público Nuevo campo Representa el porcentaje de un público para una tendencia.
Categorías de KnowledgeGraphAttributeMetadata Campos nuevos Filtra los atributos del Gráfico de conocimiento por categorías coincidentes.
Informes
Métricas de vistas de recursos Nuevas funciones o métricas Se agregaron varias métricas nuevas a AssetGroupAsset, ChannelAggregateAssetView y CampaignAggregateAssetView. Las campañas de máximo rendimiento ahora también registran los valores reales de impressions.
Extensiones de selector Función nueva Se hizo que AssetSet y CampaignAssetSet se puedan consultar juntos dentro de ChangeStatus.
search_term_targeting_status Nuevo segmento Es el segmento seleccionable en la vista de términos de búsqueda de la campaña.
final_url_expansion_asset_view Nuevo recurso de informes Informa los detalles del rendimiento de los recursos de expansión de la URL final.
Ajustes de valor del grupo de recursos Campos nuevos Se agregó compatibilidad con las métricas value_adjustment y all_value_adjustment en el informe AssetGroup.
landing_page_source Nuevo segmento Proporciona un segmento de fuente de la página de destino en landing_page_view.
search_term_match_source Nuevo segmento Es un segmento seleccionable en las vistas de términos de búsqueda y de términos de búsqueda de la campaña.
match_type Nuevo segmento Es la clave de segmento seleccionable en la vista de palabras clave.
Informes de clústeres de intención de búsqueda únicos Campos nuevos Se agregaron clicks_unique_query_clusters, conversions_unique_query_clusters y impressions_unique_query_clusters para informar clústeres únicos de intención de búsqueda.
ClickType.VEHICLE_ASSETS Valor de enum nuevo Realiza un seguimiento de los clics relacionados específicamente con los formatos de anuncios de vehículos y los registra en el informe click_view.
Exploración de Ofertas inteligentes
Parámetros de configuración de tolerancia en las estrategias de la Búsqueda Nuevos campos o parámetros de configuración Permite habilitar la Exploración de Ofertas inteligentes en las campañas de Búsqueda estableciendo target_roas_tolerance_percent_millis entre 10,000 (10%) y 30,000 (30%) inclusive (la configuración de target_roas es obligatoria para Maximizar conversiones). Consulta nuestra entrada de blog sobre la Exploración de Ofertas inteligentes y el artículo del Centro de ayuda.
Compatibilidad con informes de diversidad Función nueva Ahora se admiten los informes de diversidad agregados para las siguientes métricas de clústeres de intención de búsqueda únicos. En la IU de Google Ads, está disponible una vista segmentada por tiempo:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Videos
YouTubeVideoListAsset Nuevo recurso o campo Permite establecer vínculos entre las campañas y los activos de listas de video con Asset.youtube_video_list_asset. Consulta Cómo usar videos relacionados.
Extensiones de metadatos de estadísticas Campos nuevos Se agregaron metadatos nuevos a YouTubeChannelInsights y YouTubeVideoAttributeMetadata.
Tipos de clics interactivos Nuevos valores de enumeración Se agregaron los siguientes tipos de clics: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK y PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Nuevo campo Los anuncios de video responsivos de Lets se publican como anuncios in-stream que no se pueden omitir en las campañas que combinan formatos que se pueden omitir y que no se pueden omitir.
Configuración de la secuencia de videos Campos nuevos Se agregaron configuraciones de secuenciación de solo lectura: Campaign.VideoCampaignSettings.video_ad_sequence y VideoAdSequenceStepSetting. Consulta Acerca de la secuenciación de anuncios de video.
Segmentación por selección de contenido de video Nuevo tipo o campo de criterio Se agregaron el tipo de criterio VIDEO_LINEUP y el campo correspondiente en CampaignCriterion y AdGroupCriterion. Esta función solo está disponible para las cuentas incluidas en la lista de entidades permitidas.
Vistas de las posiciones de idoneidad del contenido Nuevos recursos de informes Se agregó un informe de idoneidad del contenido para los niveles de detalle (detail_content_suitability_placement_view) y de grupo (group_content_suitability_placement_view). Consulta Acerca del informe "Idoneidad del contenido".

Notas de la versión archivadas

Consulta Versiones descontinuadas para ver las notas de la versión archivadas.