Notas de la versión

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

Versión principal v26

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

v26 (14/10/2026)

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

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
Campo opcional country_code en LocalServicesPmaxCampaignSettings Campo obligatorio durante la creación de la campaña de máximo rendimiento de Servicios Locales (LocalServicesPmaxCampaignSettings.country_code) Cambio de comportamiento Asegúrate de especificar country_code (junto con el nuevo campo obligatorio listing_id) cuando crees campañas de máximo rendimiento de Servicios locales.
Conversiones
El campo enhanced_conversions_for_leads_enabled en ConversionTrackingSetting (Customer.conversion_tracking_setting) Ninguno Eliminación En su lugar, usa ConversionTrackingSetting.enablement_setting en Customer.conversion_tracking_setting para inspeccionar la configuración de las conversiones avanzadas a nivel de la cuenta.
Segmentación
Campos de criterios específicos del hotel en AdGroupBidModifier:
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights y max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
 Campos de criterios independientes de la vertical en AdGroupBidModifier: Cambio de nombre o eliminación Actualiza las referencias para usar los campos de criterios independientes de la vertical, que admiten la segmentación en verticales de viajes más allá de los hoteles (como Cosas que hacer). Los IDs de criterios, el comportamiento de la segmentación y los modificadores de ofertas existentes se mantienen igual. Los valores de min_nights y max_nights se transfieren a min_days y max_days tal como están.
HotelDateSelectionType y tipo de segments.user_set_dates DateSelectionType Cambio de nombre o tipo excepto porque se usa DateSelectionType en lugar de HotelDateSelectionType.
Motivos de error específicos del hotel en CriterionError:
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 Motivos de error independientes de la vertical en CriterionError: Cambiar nombre Actualiza el manejo de errores para verificar los nuevos motivos de error independientes de la vertical.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
Recursos
Proveedores de mensajes para la empresa por SMS y LINE Nuevos campos y valores de enumeración Se agregó compatibilidad con LINE y SMS como proveedores de mensajes en BusinessMessageAsset, incluidos los campos nuevos BusinessMessageAsset.line_info y BusinessMessageAsset.sms_info junto con BusinessMessageProvider.LINE y BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY Nuevo valor de enum o error Se agregó a AssetGroupError para indicar cuándo una categoría especificada en GoogleLocalServicesInfo (AssetGroup.google_local_services_info) no es compatible con las campañas de máximo rendimiento de Servicios locales.
Campañas
Creación de campañas de máximo rendimiento de Servicios Locales Nuevas funciones, campos y errores

Se actualizó PmaxCampaignSettings.local_services_enabled de OUTPUT_ONLY a IMMUTABLE, lo que permite que los clientes de API externa especifiquen local_services_enabled = true cuando crean campañas de máximo rendimiento de Servicios Locales nuevas.

También se agregó LocalServicesPmaxCampaignSettings.listing_id para exponer el ID de la ficha del Perfil de Negocio de Google vinculado a la campaña de máximo rendimiento de Servicios locales (marcado como OBLIGATORIO durante la creación de la campaña de máximo rendimiento de Servicios locales) y se agregó el código de error CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Errores de validación de las campañas de Servicios Locales Nuevos valores de enumeración y errores Se agregaron nuevos errores de validación para las campañas de Servicios locales:
Validación de la vinculación de la cuenta de Hotel Center Nuevo valor de enum o error Se agregó el código de error CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED a CampaignError para indicar que vincular un conjunto de recursos de propiedad de hotel (Campaign.hotel_property_asset_set) a una campaña de máximo rendimiento para objetivos de viaje requiere una vinculación activa de la cuenta de Hotel Center.
Presupuesto mínimo por día para las campañas de generación de demanda Nuevo campo Se agregó el campo demand_gen_info.minimum_budget_per_day_micros a CurrencyConstant, que especifica el presupuesto mínimo requerido por día para las campañas de generación de demanda en esa moneda. El valor de este campo se actualiza cuando cambia el presupuesto mínimo que aplica la API.
Configuración de la medición de efectividad de las campañas Nuevo campo Se agregó Campaign.lift_measurement_config para exponer el nombre del recurso de la configuración de medición de efectividad vinculada a la campaña.
Validación de experimentos de IA Max Nuevo valor de enum o error Se agregó el código de error ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED a ExperimentArmError cuando se intenta crear un experimento de ADOPT_AI_MAX para una campaña que ya tiene habilitada la función IA Max (o que se habilita dentro de la misma solicitud antes de la creación del grupo experimental).
Tipo de ficha de la campaña de Shopping Asistencia ampliada Se expandió la compatibilidad de Campaign.listing_type con las campañas de Shopping.
Actualizaciones de la autodeclaración de publicidad política de la UE Comportamiento actualizado y campos nuevos

Campaign.contains_eu_political_advertising ahora es opcional para algunas campañas que no se segmentan de forma positiva para la Unión Europea.

  • Excepto como se indica para las campañas de DEMAND_GEN con segmentación actualizada, el campo es opcional si una campaña cumple con todas las condiciones siguientes después de que se ejecuta la solicitud:
    • No contiene ningún criterio de campaña de ubicación positiva que se encuentre dentro de la UE.
    • No contiene ningún criterio de campaña positivo de proximidad o grupos por ubicación
    • Contiene, al menos, un criterio de campaña de ubicación positiva que se encuentra fuera de la UE.
  • En el caso de las campañas de DEMAND_GEN con upgraded_targeting, el campo es opcional si cada grupo de anuncios activo de la campaña satisface todas las siguientes condiciones después de que se ejecuta la solicitud:
    • No contiene ningún criterio de grupo de anuncios de ubicación positiva que se encuentre dentro de la UE
    • No contiene ningún criterio de grupo de anuncios de proximidad o grupo por ubicación positivo
    • Contiene, al menos, un criterio de ubicación positivo del grupo de anuncios que se encuentra fuera de la UE.
    El campo también es opcional para las campañas que no tienen grupos de anuncios activos. Si una solicitud crea un grupo de anuncios que no cumple con estas condiciones, se devuelve AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
  • Estos cambios se aplican a las campañas nuevas y existentes. En algunos casos, solo se puede crear una campaña nueva si se agregan criterios en la misma solicitud. Usa GoogleAdsService.Mutate para agrupar las mutaciones.
  • Se actualizó Campaign.missing_eu_political_advertising_declaration para que coincida con los cambios en Campaign.contains_eu_political_advertising.
  • Se agregó GeoTargetConstant.require_eu_political_advertising_declaration para indicar si una ubicación está dentro o fuera de la UE.
  • Se agregaron CampaignCriterion.require_eu_political_advertising_declaration y AdGroupCriterion.require_eu_political_advertising_declaration. Campaign.contains_eu_political_advertising es obligatorio si este campo es true para cualquier criterio a nivel de la campaña (o para cualquier criterio activo a nivel del grupo de anuncios en las campañas de DEMAND_GEN con segmentación actualizada). Los campos devuelven true si el campo negative del criterio es false y el criterio es una ubicación dentro de la UE, una proximidad (independientemente de si se superpone con el territorio de la UE) o un grupo por ubicación (independientemente de si se superpone con el territorio de la UE).
Conversiones
Configuración unificada de las conversiones avanzadas Campos y enumeración nuevos Se agregaron ConversionTrackingSetting.enablement_setting y ConversionTrackingSetting.effective_enablement_setting (en Customer.conversion_tracking_setting) para exponer la configuración unificada de las conversiones avanzadas de la cuenta, que se representa con el nuevo enum EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Valor de enum nuevo Se agregó a ConversionActionCategory para admitir interacciones de mensajes o chats que indican interés en la oferta de un anunciante.
ConversionAttributionEventType.CLICK Valor de enum nuevo Se agregó a ConversionAttributionEventType para representar las conversiones atribuidas a un clic en un anuncio, que antes se incluían en el valor de enumeración UNKNOWN.
General
Actualizaciones de clientes potenciales de Servicios Locales Nuevo campo y valor de enum
Recomendaciones
Recomendación de aumento de presupuesto para la Búsqueda Nueva recomendación Se agregaron RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation y ApplyRecommendationOperation.raise_budget_performance_too_low para admitir el aumento de los presupuestos cuando los presupuestos diarios son demasiado bajos para las campañas de Búsqueda.
Informes
Mediciones de Efectividad de búsqueda Nuevas funciones, recursos, segmentos y métricas Se agregó compatibilidad con las mediciones de la Efectividad de búsqueda:
Vista de recursos de la expansión de la URL final para las campañas de Shopping Compatibilidad expandida Se expandió final_url_expansion_asset_view para admitir las campañas de Shopping (con ad_group seleccionable como recurso atribuido junto con final_url_expansion_asset_view.ad_group).
Videos
Divulgaciones de contenido generado por IA de YouTube Nuevos campos y enumeración Se agregó compatibilidad con las divulgaciones de contenido generado por IA para las cargas de YouTube. Se agregó el nuevo campo YouTubeVideoUpload.video_content_metadata de tipo VideoContentMetadata a YouTubeVideoUpload, que contiene la configuración de divulgación en VideoContentMetadata.generative_content_disclosure de tipo YouTubeVideoUploadGenerativeContentDisclosure.

Versiones principales y secundarias de la v25

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

v25.2 (23/9/2026)

Las siguientes funciones y actualizaciones nuevas se agregaron en la versión 25.2 de la API de Google Ads. Las versiones secundarias, como la v25.2, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Recursos
Opciones de URL para AssetGroup Campos nuevos Se agregó compatibilidad con las opciones de URL en AssetGroup, lo que permite a los anunciantes especificar plantillas de seguimiento, parámetros personalizados y sufijos de URL final a nivel del grupo de recursos:
Campañas
Información sobre el rastreo automático de videos Campos y enumeraciones nuevos Se agregó AutomatedVideoCrawlSetting a Campaign.AssetAutomationSetting, junto con AssetAutomationType.AUTOMATED_VIDEO_CRAWL, lo que te permite especificar la configuración de rastreo de video automatizado para una campaña de máximo rendimiento. AutomatedVideoCrawlSetting.automated_video_crawl_infos contiene una lista de entradas AutomatedVideoCrawlInfo, cada una de las cuales configura un rastreo url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL o YOUTUBE) y el estado de habilitación de enabled.
Errores del multiplicador de valores de la optimización del ciclo de vida del cliente Nuevos valores de enum y errores Se agregaron nuevos motivos de error de validación cuando se configuran multiplicadores de valor (value_multiplier y high_lifetime_value_multiplier) para la optimización del ciclo de vida del cliente:
SmartCampaignSettingService.GeneratePMaxDraftCampaign Función nueva Se agregó SmartCampaignSettingService.GeneratePMaxDraftCampaign para admitir la generación de un borrador de campaña de máximo rendimiento a partir de una campaña inteligente existente, inicializada con el estado CampaignStatus.PAUSED y el estado de creación CampaignCreationStatus.INCOMPLETE (consulta Cómo convertir campañas inteligentes en campañas de máximo rendimiento):
Conversiones
Impresiones de anuncios de Firebase Nuevos tipos y categorías de acciones de conversión Se expusieron los tipos de acciones de conversión FIREBASE_ANDROID_APP_AD_IMPRESSION y FIREBASE_IOS_APP_AD_IMPRESSION, lo que te permite recuperar y modificar estas acciones de conversión. También se expuso la categoría IN_APP_AD_REVENUE en ConversionActionCategory para hacer un seguimiento de los ingresos de monetización de anuncios en la app.
General
BusinessProfileLocationSyncError Nueva enumeración y errores Se agregaron motivos para los errores de sincronización de la ubicación del Perfil de Negocio cuando se sincronizan ubicaciones en un AssetSet con el tipo LOCATION_SYNC. En lugar de devolver un error genérico UNKNOWN, la API ahora devuelve BusinessProfileLocationSyncError con motivos específicos (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED y NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planificación
Métricas de percentil BenchmarksService.GenerateBenchmarksMetrics Nuevas funciones

Se actualizó BenchmarksService.GenerateBenchmarksMetrics para proporcionar métricas que representan la posición competitiva del cliente entre otros anunciantes en formato de nivel de percentil. Las métricas se muestran en PercentileMetrics en el nuevo campo CustomerMetrics.percentile_metrics (en GenerateBenchmarksMetricsResponse.customer_metrics y BreakdownMetrics.customer_metrics) y se representan con BenchmarksCustomerPercentileTier.

CustomerMetrics.percentile_metrics solo se propaga cuando se cumplen las dos condiciones siguientes en GenerateBenchmarksMetricsRequest:

Se agregó compatibilidad con las métricas de percentil para las fechas de trimestre abierto dentro de ListBenchmarksAvailableDatesResponse.supported_dates (que devuelve BenchmarksService.ListBenchmarksAvailableDates). Si bien las métricas agregadas de clientes (CustomerMetrics.aggregate_metrics), las métricas de porcentaje de clientes (CustomerMetrics.average_rate_metrics) y las métricas de percentil de clientes (CustomerMetrics.percentile_metrics) son compatibles con todas las fechas en supported_dates (incluidos los trimestres abiertos), las métricas de porcentaje de clientes (CustomerMetrics.share_metrics) y las métricas de porcentaje de la fuente de comparativas (average_benchmarks_metrics, como average_cpm de los anuncios de "/Apparel/Clothing") no son compatibles con los trimestres abiertos y se omiten de la respuesta, a menos que el date_range solicitado se encuentre dentro del rango más estrecho de ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics.

Se agregó un error BenchmarksError.NO_METRICS_FOUND personalizado que indica que no se encontraron métricas para la combinación de entradas seleccionada para mejorar la usabilidad.
Identificadores de canales de YouTube para obtener estadísticas de los creadores Función nueva Se actualizó ContentCreatorInsightsService.GenerateCreatorInsights para admitir la búsqueda por identificadores de canales de YouTube con YouTubeChannels.youtube_channel_handles (los identificadores de canales válidos deben comenzar con @, como @channel_handle). Esta opción es similar a la búsqueda por IDs de canales de YouTube. La respuesta contiene estadísticas sobre los creadores de YouTube solicitados.
Recomendaciones
Recomendaciones de ofertas de CPA y ROAS Nuevas recomendaciones Se agregaron Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) y Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), junto con ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low y ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, para admitir el aumento del CPA objetivo o la disminución del ROAS objetivo cuando las ofertas son demasiado bajas para que las campañas de Búsqueda participen en las subastas:
Informes
Segmentos de dimensiones de itinerarios de hoteles Nuevos segmentos Se agregaron los siguientes segmentos de dimensiones de itinerarios de reservas de hoteles y viajes a Segments (seleccionables con campaign, ad_group y customer):
Métricas de anuncios verticales Métricas nuevas Se agregaron las siguientes métricas para los informes de anuncios verticales de hoteles y viajes a Metrics (seleccionables con campaign, ad_group y customer):
Segmentos de anuncios verticales Segmentos nuevos Se agregaron los siguientes segmentos para los informes de anuncios verticales de hoteles y viajes a Segments (se pueden seleccionar con campaign, ad_group y customer):

v25.1 (19/8/2026)

Se agregaron las siguientes funciones y actualizaciones nuevas en la versión 25.1 de la API de Google Ads. Las versiones secundarias, como la v25.1, no contienen cambios rotundos.

Funciones y actualizaciones Tipo Descripción
Recursos
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Nuevos valores de enumeración Se agregó compatibilidad con los recursos de aviso importante de texto.
Campañas
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Campos nuevos Realiza un seguimiento de la próxima migración automática a IA Max.
Conversiones
Mediciones de Brand Lift Nuevas funciones Se agregó compatibilidad con las mediciones de Brand Lift con las siguientes actualizaciones:
Mediciones de Efectividad de conversiones Nuevas funciones Se agregó compatibilidad con las mediciones de Efectividad de conversiones con las siguientes actualizaciones:
  • Se agregó un nuevo recurso de solo lectura LiftMeasurementConfig que representa un estudio de efectividad.
  • Se agregaron nuevos segmentos seleccionables para segmentar y filtrar los resultados de efectividad.
  • Se agregaron 24 métricas nuevas de Efectividad de conversiones y métricas de puntuación de ganadores que admiten un análisis estadístico detallado del rendimiento de la efectividad.
  • Se agregó compatibilidad para recuperar los detalles de la campaña y los objetivos de conversión.
  • Se agregó un nuevo campo opcional Experiment.lift_measurement_config.
  • Se agregó la enumeración ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Recurso nuevo Es un nuevo recurso de solo lectura que representa los detalles del período de medición de una configuración de medición de efectividad, incluidas las fechas de inicio y finalización del período de medición (start_date y end_date).
General
SmartCampaignError Nuevos valores de enumeración Se agregaron nuevos códigos de error específicos para las restricciones de generación de las campañas de máximo rendimiento:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Nuevo valor de enum o error Se muestra cuando un proyecto de Google Cloud con un nivel de acceso TEST intenta realizar solicitudes en una cuenta que no es de prueba.
Planificación
Estadísticas de opinión de la marca Nuevas funciones Se agregó compatibilidad con las estadísticas de opinión sobre la marca en ContentCreatorInsightsService:
BenchmarksService mejoras Nuevas funciones Se agregó compatibilidad con las categorías como filtros para definir el alcance de un análisis de comparativas. También se admiten métricas adicionales críticas para la empresa:
Segmentación por estado parental Función nueva Se agregó compatibilidad con la segmentación por estado parental en la planificación de alcance. Se agregó el nuevo campo parental_statuses a Targeting para el servicio ReachPlanService.GenerateReachForecast y parental_statuses a PlannableTargeting para el servicio ReachPlanService.ListPlannableProducts.
Recomendaciones
Recommendation.campaign_specific_app_goal_recommendation Nueva recomendación Sugiere agregar un objetivo de conversión de aplicación específico de la campaña. El nuevo recurso EffectiveAutomaticGoal se usa para representar los objetivos actuales dentro de esta recomendación.
Informes
Metrics.original_conversion_value Nuevo campo Representa el valor de conversión original de las conversiones aptas para ofertas. Es el valor de las conversiones sin ajustar antes de que se apliquen los ajustes de las reglas de valor, como las reglas de valor de conversión o los ajustes de los objetivos de ciclo de vida.
Estadísticas de membresía de lealtad Nuevas funciones Se agregó compatibilidad para segmentar las estadísticas según el estado del programa de membresía de lealtad del usuario y se agregó la dimensión principal de la membresía de lealtad para las reglas de valor de conversión:
  • Se agregó el segmento Segments.loyalty_membership para admitir la segmentación de las métricas del informe según el nivel del programa de lealtad del usuario que generó la conversión.
  • Se agregó la dimensión principal LOYALTY_MEMBERSHIP para identificar cuándo se cumplió una condición de membresía de lealtad para una regla de valor de conversión.
Segmentación
vertical_ads_item_bid Nuevo tipo de criterio Se agregó el nuevo tipo de criterio vertical_ads_item_bid a AdGroupCriterion.criterion.

v25 (22/7/2026)

Las siguientes funciones nuevas, actualizaciones y cambios rotundos se agregaron en la versión 25 de la API de Google Ads, que es una versión principal.

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
Campos independientes additional_value y additional_high_lifetime_value en CustomerLifecycleOptimizationValueSettings Forman parte de los oneofs value_adjustment y high_lifetime_value_adjustment, respectivamente, junto con los nuevos campos value_multiplier y high_lifetime_value_multiplier. Cambio estructural Actualiza las referencias a estos campos, ya que ahora forman parte de oneofs.
Recursos heredados de CustomerLifecycleGoal y CampaignLifecycleGoal, sus servicios correspondientes CustomerLifecycleGoalService y CampaignLifecycleGoalService, y la configuración o enumeraciones heredadas (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Ninguno Eliminación Usa el esquema de objetivos unificados renovado:
General
Campos de enumeración anidados en los mensajes de solicitud y respuesta del servicio de incentivos:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Campos de enumeración independientes: Cambio de nombre o eliminación Usa los nuevos campos de enumeración independientes en lugar de los campos type heredados.
Campos opcionales selected_incentive_id y customer_id en ApplyIncentiveRequest Campos obligatorios Cambio de comportamiento Asegúrate de proporcionar ambos campos cuando llames a ApplyIncentive.
El campo de dirección de correo electrónico del consumidor ContactDetails.email en el recurso LocalServicesLead Ninguno Eliminación Quita las referencias a este campo porque ya no se admite.
Campo opcional allowed_domain en AdvertisingPartnerLinkInvitationProperties Campo obligatorio cuando se llama a CreateProductLinkInvitation para un socio publicitario Cambio de comportamiento Asegúrate de proporcionar allowed_domain cuando crees una invitación de vinculación con otro producto para un socio publicitario.
Planificación
El campo search_brand en GenerateCreatorInsightsRequest Ninguno Eliminación En su lugar, usa search_topics.
El campo plannable_location_id en Targeting y el campo cookie_frequency_cap en GenerateReachForecastRequest Ninguno Eliminación Cambia al uso de plannable_location_ids y cookie_frequency_cap_setting.
Informes
Campo customer_metrics en GenerateBenchmarksMetricsResponse y BreakdownMetrics de tipo Metrics Campo de tipo CustomerMetrics Cambio de tipo o de comportamiento Actualiza tus integraciones para usar el nuevo tipo CustomerMetrics, que solo contiene métricas que representan el rendimiento de los anuncios del cliente.

Funciones y actualizaciones (sin interrupciones)

Funciones y actualizaciones Tipo Descripción
Anuncios
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Nuevo valor o comportamiento de enum Disponible para DemandGenMultiAssetAds. Si se habilita, genera imágenes animadas a partir de imágenes no animadas como entrada. Los nuevos DemandGenMultiAssetAds se habilitan de forma predeterminada a partir de esta versión de la API.
Mutabilidad de la información del contenido sintético Cambio de comportamiento Asset.synthetic_content_info y Ad.synthetic_content_info ahora son completamente mutables en las versiones 25, 24 y 23.
Campañas
Objetivo de retención de lealtad Nuevas funciones y parámetros de configuración Se agregó compatibilidad con el objetivo de retención de clientes leales, que permite a los anunciantes optimizar las campañas para retener a los miembros del programa de lealtad.
Objetivo de adquisición de clientes nuevos Nuevas funciones o parámetros de configuración Se actualizó la compatibilidad con el objetivo de adquisición de clientes nuevos en la API de Google Ads para reflejar el esquema de objetivos unificados renovado:
Conversiones
Atribución de conversiones de terceros de YouTube Campos nuevos Se agregó compatibilidad con la verificación de la atribución de conversiones de YouTube a través de socios externos: Consulta el artículo del Centro de ayuda para obtener más información.
General
ContactDetails.phone_number_extension Nuevo campo Se agregó al recurso LocalServicesLead.
IncentiveError Nuevos valores de enum y errores Se agregaron nuevos códigos de error específicos para las fallas en el canje de incentivos:
Planificación
Detalles del canal de YouTube en las estadísticas de tendencias Campos nuevos Se agregó compatibilidad con más detalles de los canales de YouTube de los videos relacionados cuando se buscan estadísticas de tendencias. Se agregaron los nuevos campos channel_id, channel_name y channel_url a YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given Nuevo campo Agregado a YouTubeChannelInsights Esto se aplica si un creador aceptó compartir datos no públicos. Si es así, se completan los siguientes campos:
Informes
ad_sub_format_type Nuevo segmento Proporciona un desglose de los anuncios in-stream que no se pueden omitir de YouTube por duración: Este segmento siempre se debe seleccionar junto con ad_format_type. Se puede seleccionar con AdGroup, AdGroupAd, Campaign, Customer, Video y VideoEnhancement.
Métricas de redes sociales específicas de los videos Nuevos campos o métricas Se agregaron métricas sociales específicas de video para ayudar a los anunciantes a hacer un seguimiento de la participación de los usuarios (comentarios, Me gusta y veces que se compartió) en los anuncios de Shorts en YouTube: Están disponibles en AdGroup, AdGroupAd, Asset, Campaign, Customer y Video.

Versiones principales y secundarias de v24

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

v24.2 (24/6/2026)

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

Funciones y actualizaciones Tipo Descripción
Anuncios
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Nuevo valor de enum 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 se habilitan de forma predeterminada a partir de esta versión de la API).
Recursos
AssetGroup.google_local_services_info Nuevo campo Se agregó para admitir 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ó para admitir 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 de enum o error Se devuelve cuando se intenta quitar todos los grupos de recursos de una campaña.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nuevo valor de enum o error 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 que se pueden seleccionar para los grupos de anuncios de generación de demanda.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Nuevo valor de enum / error 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 de enum / error Se devuelve cuando se intenta crear campañas inteligentes nuevas.
Conversiones
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Nuevos valores de enum 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 enum 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: Se utiliza para los experimentos de optimización de las campañas de máximo rendimiento relacionados con 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 declaraciones de contenido sintético o generado por IA, divididas en advertiser_attestation (declaraciones proporcionadas directamente por el anunciante) y system_attestation (declaraciones detectadas o proporcionadas automáticamente por el sistema).

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

Para ayudarte a planificar tu próximo trabajo de integración para la versión 25, se presentará la interfaz para mutar los campos de certificación del anunciante de forma anticipada para la versión 22 y 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 modificación en cualquiera de estos campos, se devolverá uno de los siguientes errores:

"The field attempted to be mutated is immutable" o "Field cannot be set".

Estos campos serán completamente mutables a partir de la versión 25. Te recomendamos usar la interfaz ahora para compilar y probar tu lógica interna, de modo que tu sistema esté listo para las funciones de escritura completas cuando se lance la versión 25.
Autorización multiusuario Nuevas funciones Se agregó compatibilidad con las revisiones de autorización de varias partes (MPA):
Esta función se adaptó a las versiones 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 de forma correcta a devolver 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 creadores que hablen sobre un tema en el país especificado en country_locations (solo admite la búsqueda de 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 / opciones Contiene opciones de búsqueda adicionales para los temas de ListAudienceInsightsAttributes, incluidas 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. Expone 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 realizar búsquedas de estadísticas de tendencias con la ubicación del país y las ubicaciones de las regiones.
Informes
PerformanceMaxPlacementView Extensión de segmentos Se puede segmentar por ad_network_type.
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 de enum / error Se devuelve cuando se intenta segmentar 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)

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

Funciones y actualizaciones Tipo Descripción
Anuncios
DemandGenMultiAssetAdInfo.classic_display_images Nuevo campo Las imágenes de display subidas personalizadas 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: Se utiliza para los experimentos que evalúan 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: Se utiliza para los 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: Se usa para los experimentos personalizados que optimizan los 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 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 optimización de recursos.
  • 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 Es un 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 por la plataforma del dispositivo del usuario (como iOS o Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Nuevo valor de enum / error 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 los 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 los campos de estimación puntual, margen de error y valor p.
Segmentación
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nuevo valor de enum o error 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 la 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)

Las siguientes funciones nuevas, actualizaciones y cambios rotundos se agregaron en la versión 24 de la API de Google Ads, que es una versión principal.

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.
Opcionales videos, business_name y logo_images en VideoResponsiveAdInfo Campos obligatorios Cambio de comportamiento Proporciona videos, business_name y logo_images cuando crees o modifiques anuncios responsivos de video. 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 de registros de lealtad. Quita las referencias de código a ella.
Planificación
Tipo InsightsAudienceAttributeGroup para topic_audience_combinations Tipo common.InsightsAudienceAttributeGroup Cambio de comportamiento o de tipo Las integraciones de bibliotecas cliente con tipos deben actualizarse para usar los nuevos espacios de nombres de recursos.
Campo youtube_select_lineups en ReachPlanService.ListPlannableProducts Ninguno Eliminación Cambia al uso de selecciones de contenido 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 de previsión o plan de palabras clave obsoletos en GenerateKeywordForecastMetrics Ninguno Eliminación Se quitaron los siguientes campos y tipos de planes o 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 No hay fallas parciales Cambio de comportamiento Las solicitudes fallarán y arrojarán un error si alguno de los IDs que contienen no pasa la validación.
Códigos heredados de ShareablePreviewError: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Cambio de nombre / cambio de 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. Actualiza 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 los atributos de los 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 las conversiones posimpresión (VTC) (false de forma predeterminada) 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 Valores de enum nuevos 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 de enum o error Se devuelve cuando se intenta crear varias listas similares 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 el estado 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 nuevas, actualizaciones y cambios rotundos.

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 modificación en cualquiera de estos campos, se devolverá uno de los siguientes errores:

"The field attempted to be mutated is immutable" o "Field cannot be set".

Estos campos serán completamente mutables a partir de la versión 25. Te recomendamos usar 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)

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

Funciones y actualizaciones Tipo Descripción
Recursos
VideoEnhancement Recurso nuevo Contiene información del anuncio de video específica de la mejora, como si lo generó Google o lo proporcionó 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 Proporcionar restricciones de programación más detalladas para 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 genera un error cuando se intenta usar esta categoría de tipo de cliente de la lista de usuarios que ya no está 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 el CPC de la estrategia Maximizar clics de las campañas de generación de demanda 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 las vistas previas de YouTube en vivo configurando preview_type como YOUTUBE_LIVE_PREVIEW. Se agregaron UNSUPPORTED_AD_TYPE y TOO_MANY_RESOURCES_IN_REQUEST a ShareablePreviewError. Esta función solo se admite 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 cuentas
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 Valores de enum nuevos Se agregaron CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED y BOOKING_CANCELLED para proporcionar los motivos del estado principal 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 Nuevo valor de enum Admite el seguimiento de los usuarios que miran un anuncio y, luego, un video del mismo canal.
General
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Nuevo valor de enum / error Se devuelve cuando se intenta segmentar solo la categoría indeterminada en las dimensiones demográficas.
Incentivos
IncentiveErrorEnum Nuevos valores de enum / errores 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 con los desgloses de fechas con un BreakdownDefinition.
ReachPlanService.GenerateReachForecast Valor de enum nuevo Se agregó GOOGLE_DISPLAY_NETWORK como plataforma de segmentación para las campañas de generación de demanda con la estrategia Maximizar conversiones.
GenerateTrendingInsights Campos nuevos Se agregó información de la línea de tendencia histórica en TrendInsightDataPoint a TrendInsights cuando se busca por tema.
Informes
Métricas de frecuencia de usuarios únicos Campos nuevos Se agregaron nuevas métricas 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 Nuevo valor de enum Se agregó VERTICAL_ADS_DATA_FEED para admitir feeds de datos de anuncios verticales, como la segmentación por entidad de 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 rotundos.

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 devolverá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 quitan los campos originales que solo contienen fechas.
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
Métricas y enumeración de etiquetas de rendimiento de recursos agregados Ninguno Eliminación Se quitaron las métricas de etiquetas de rendimiento de activos agregados. Ya no se devuelve la enumeración de la etiqueta de rendimiento para las campañas de 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.
asset_group_asset vista 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ó el 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 enum 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 Recursos de mensaje para la empresa actualizados:
Facturación
InvoiceService.ListInvoices Nuevas opciones Ahora, se pueden mostrar detalles más detallados en Invoice, incluido el desglose de costos a nivel de la campaña, los costos regulatorios detallados y la información de ajuste, configurando include_granular_level_invoice_details en ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Nuevos enums Se agregaron enumeraciones auxiliares para las tasas reglamentarias y las unidades de medida.
Campañas
CampaignError Nuevos valores de enum / errores Se agregaron los códigos de error DURATION_TOO_LONG_FOR_TOTAL_BUDGET y END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversiones
ConversionActionCategory Nuevo valor de enum 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 aventura (CYO):

Para facilitar un 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 personales en GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport y GenerateCreatorInsights.

Los acontecimientos personales no son compatibles con otros métodos de AudienceInsightsService, como AudienceInsightsService.GenerateAudienceOverlap y AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nuevos campos o opciones Ahora, la respuesta incluye plataformas para admitir sugerencias de porcentaje de conversiones basadas en los controles de plataforma (p.ej., Gmail, Shorts). Solo se admite para las campañas de generación de demanda.
LanguageDistribution Nuevo campo o tipo Se agregó a YouTubeChannelInsights para proporcionar detalles de distribución de idiomas en el contenido de los canales de YouTube.
BenchmarksService Servicio nuevo Compara los datos de publicidad de YouTube con las comparativas de sectores.
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 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 establece en true para las recomendaciones de CAMPAIGN_BUDGET, se utiliza un modelo optimizado para clientes nuevos (solo se recomienda para clientes sin 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 Se habilitó el desglose por tipo de red de publicidad 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 Segmentos nuevos 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 por grupos de artículos en las campañas de Búsqueda con feeds de viajes.
Integración del feed de datos de anuncios verticales Función nueva Ahora se puede conectar un feed de datos de anuncios verticales a una campaña de Búsqueda que use IA Max para mostrar anuncios de viajes de promoción de hoteles y con 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 por 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 de enum / error 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 informan si un anuncio era audible y en cuántas impresiones se pudo medir la audibilidad.

Notas de la versión archivadas

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