Notas de la versión

v24.1 (13/5/2026)

En la versión 24.1, se agregaron las siguientes funciones y actualizaciones nuevas.

Anuncios

  • Se agregó el campo classic_display_images a DemandGenMultiAssetAd. Son imágenes personalizadas que se suben y se publican sin necesidad de recursos adicionales y que no forman parte de los formatos de anuncios responsivos.

General

Experimentos

  • Se agregó compatibilidad con los siguientes tipos de ExperimentTypeEnum nuevos:
    • 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.
  • Se agregó compatibilidad con la configuración de experimentos existentes de YOUTUBE_CUSTOM que constan de campañas de video, con el nuevo campo video_experiment en Experiment.
  • Se agregaron los siguientes campos a ExperimentArm para admitir la configuración de pruebas de recursos, grupos de recursos y experimentos de campañas de máximo rendimiento:
    • 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 del 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.

Informes

Segmentación

  • Se agregó CANNOT_EXCLUDE_ALL_TARGETS a CriterionErrorEnum. Este error se muestra cuando se intenta excluir todos los objetivos demográficos, lo que no está permitido.

Videos

  • Publica ZEFR como socio de integración de visibilidad externo.
  • Se agregó channel_id al campo youtube_video del recurso DataLink para exponer el ID del canal de YouTube asociado con la vinculación de datos.

v24 (22/4/2026)

En la versión 24, se agregaron las siguientes funciones y actualizaciones nuevas.

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

Anuncios

Los siguientes campos ahora son obligatorios:

Recursos

Campañas

Conversiones

  • Se agregó compatibilidad con los tipos de conversiones de las campañas de generación de clientes potenciales. Estos son los nuevos enumeradores de ConversionActionType en la versión 24:

    • 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
  • Se quitó la categoría de tipo de cliente de la lista de usuarios LOYALTY_SIGN_UPS.

General

Planificación

Informes

Shopping

  • Se agregó compatibilidad con las campañas de aplicaciones en el recurso ShoppingProduct. Ten en cuenta que los campos status y issues no se admiten en las campañas de aplicaciones.
  • Se introdujo el filtrado de productos basado en etiquetas con expresiones lógicas para las campañas de Shopping.
    • Se agregaron los tipos de criterios RETAIL_FILTER_BUNDLE y RETAIL_FILTER.
    • Se agregó RETAIL_FILTER como un nuevo SharedSetType.
    • AdGroupCriterion ahora puede usar el campo retail_filter_bundle para vincularse a un SharedSet de tipo RETAIL_FILTER.
    • SharedCriterion ahora puede usar el campo retail_filter para definir reglas o expresiones de etiquetas individuales dentro de SharedSet.
    • Se agregó RETAIL a ListingGroupFilterListingSource
    • Se agregó la dimensión RetailFilter a AssetGroupListingGroupFilter.
    • Se agregaron nuevos códigos de error en CriterionError y AssetGroupListingGroupFilterError para la validación.
    • Esta función solo está disponible para los usuarios incluidos en la lista de entidades permitidas.

Videos

v23.2 (25/3/2026)

En la versión 23.2, se agregaron las siguientes funciones y actualizaciones nuevas.

Recursos

  • Se agregó el recurso VideoEnhancement con información específica de la mejora de los anuncios de video, como si se generó en Google o si la proporcionó el anunciante. Consulta Acerca de las mejoras de video para obtener más información.
  • Se agregó el recurso de solo lectura AppTopCombinationView para proporcionar estadísticas sobre las combinaciones de recursos con mejor rendimiento en las campañas de aplicaciones.
  • Se agregó compatibilidad para recuperar CustomerAsset con field_type BUSINESS_LOGO.

Campañas

General

  • Se agregaron dos códigos de error nuevos a CustomerClientLinkError: MAX_CUSTOMER_LIMIT_REACHED y ACCOUNT_CREATION_POLICY_VIOLATION.
  • Ahora se arroja un error cuando se intenta usar la categoría de tipo de cliente de la lista de usuarios LOYALTY_SIGN_UPS que se descontinuó.

Planificación

Informes

  • Se agregó la métrica biddable_indirect_install_first_in_app_conversion_micros a los recursos Campaign, Customer y AdGroup.

Videos

  • Se extendió ShareablePreviewService para admitir vistas previas de YouTube en vivo. Para ello, se configuró 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, se agregaron las siguientes funciones y actualizaciones nuevas.

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

Administración de la cuenta

  • Se agregó advertising_partner_properties.allowed_domain a los recursos ProductLinkInvitation y ProductLink. El socio publicitario solo podrá publicar anuncios en este dominio.
  • Se agregó el campo contains_eu_political_advertising al recurso Customer. Este 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

  • 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.
  • Se agregaron CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED y CampaignPrimaryStatusReason.BOOKING_CANCELLED para proporcionar los motivos principales del estado de las campañas con la estrategia de ofertas FIXED_CPM.
  • Se agregaron Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure y Campaign.VideoCampaignSettings.booking_details(solo lectura).
  • Se agregó Campaign.missing_eu_political_advertising_declaration para admitir consultas y filtros de campañas que no tienen declaraciones sobre si contienen publicidad política segmentada para la UE.

Conversiones

  • Se agregó ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS para admitir el seguimiento de los usuarios que miran un anuncio y, luego, miran un video del mismo canal.

General

  • Se agregó CANNOT_TARGET_ONLY_UNDETERMINED a CriterionErrorEnum. Este error se muestra cuando se intenta segmentar solo para la categoría indeterminada en las dimensiones demográficas.

Incentivos

  • Se agregaron dos códigos de error nuevos a IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED y ACCOUNT_TOO_OLD. Estos errores se pueden devolver para las solicitudes realizadas a partir del 11 de marzo de 2026.

Planificación

Informes

  • 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.
  • Se agregó VERTICAL_ADS_DATA_FEED a SearchTermMatchSourceEnum para admitir feeds de datos de anuncios verticales, como la segmentación por entidades de los anuncios de viajes.

YouTubeVideoUpload

  • 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, se agregaron las siguientes funciones y actualizaciones nuevas.

Anuncios

  • Se agregó AD_SHARING_NOT_ALLOWED a AdGroupAdErrorEnum. Este error se devuelve cuando se intenta compartir un anuncio entre varios grupos de anuncios, lo que ya no se permite.
  • Se agregaron nuevos tipos de formato a AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK y VERTICAL_ADS_PROMOTION.
  • Se quitó la compatibilidad con CallAd y CallAdInfo en la versión 23. Consulta Acerca de los anuncios de llamada para obtener más información.

Recursos

Facturación

Campañas

Conversiones

  • Se agregó YOUTUBE_FOLLOW_ON_VIEWS a ConversionActionCategory para admitir el seguimiento de los usuarios que miran un anuncio y, luego, miran un video del mismo canal.

Generación de demanda

Incentivos

  • Se agregó compatibilidad con los incentivos de Elige tu propia oferta (CYO), lo que permite a los socios recuperar y aplicar de forma programática los incentivos de Google Ads para sus clientes:

    • Se agregó IncentiveService:
      • El método FetchIncentive permite recuperar los incentivos disponibles para un usuario según el país, el idioma y, de manera opcional, el correo electrónico del usuario. Esto puede devolver opciones de incentivos personalizadas de "Elige tu propia aventura" (CYO).
      • El método ApplyIncentive permite aplicar un incentivo seleccionado por el usuario a una cuenta de cliente específica de Google Ads.
    • Se agregó el recurso de solo lectura AppliedIncentive, al que se puede consultar a través de GoogleAdsService.Search y GoogleAdsService.SearchStream. Proporciona detalles sobre los incentivos canjeados, incluido su estado, el progreso del cumplimiento, los importes de las recompensas y las fechas relevantes.
    • Se agregaron nuevos códigos de error en IncentiveErrorEnum para controlar problemas relacionados con la recuperación o la aplicación de incentivos.
    • Se agregó INVALID_EMAIL_ADDRESS a AuthenticationErrorEnum.
  • Para facilitar el control 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

Recomendaciones

  • Se agregó el campo is_new_customer a GenerateRecommendationsRequest. Cuando se establece en true para las recomendaciones de tipo CAMPAIGN_BUDGET, genera recomendaciones con un modelo para clientes nuevos. Esto solo se recomienda para los clientes que no tienen campañas.

Informes

  • Métricas y segmentación

    • AdGroupAdAssetView ahora admite métricas de impresiones, rendimiento y conversiones para RESPONSIVE_DISPLAY_AD.
    • Se agregó el segmento ad_sub_network_type para obtener un desglose más detallado del rendimiento dentro de una red de publicidad. Inicialmente, está disponible para las campañas de generación de demanda en YouTube (in-stream, in-feed y Shorts). Este segmento se debe seleccionar junto con ad_network_type.
    • Es el desglose del tipo de red publicitaria habilitado para las campañas de máximo rendimiento.
    • Ahora, UserLocationView y GeographicView admiten métricas 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
      • cross_device_conversions_value_by_conversion_date.
  • Nuevos segmentos para los anuncios verticales

  • Vistas nuevas:

    • Se agregó PerStoreView para consultar los detalles de la ubicación de la tienda.
    • Se agregó MatchedLocationInterestView para las campañas de IA Max, que proporciona métricas de rendimiento desglosadas por ubicaciones geográficas en las que los usuarios mostraron interés.
  • Performance Max:

    • Es el desglose del tipo de red publicitaria habilitado para las campañas de máximo rendimiento.
  • Eliminaciones:

    • Se quitaron las métricas de etiquetas de rendimiento de recursos agregados. El enum de la etiqueta de rendimiento ya no se devuelve para la Búsqueda y Display.

Shopping

  • ShoppingPerformanceView 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, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date y value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView ahora admite las siguientes métricas de la competencia: 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.
  • Se agregó product_image_uri a ShoppingProduct.

Anuncios verticales

  • Se agregó vertical_ads_format_setting a AdGroup para las campañas de búsqueda que utilizan feeds de viajes, lo que permite controlar qué formatos de anuncios se pueden publicar.
  • Se agregó el tipo de criterio vertical_ads_item_group_rule_list a AdGroupCriterion. Se agregó vertical_ads_item_group_rule a SharedCriterion. Estos criterios permiten segmentar grupos de artículos en campañas de Búsqueda con feeds de viajes.
  • Ahora puedes conectar un feed de datos de anuncios verticales a una campaña de búsqueda que ejecute IA Max para que muestre anuncios de promoción de propiedades y de vínculos para reservar viajes junto con tus anuncios de texto. A nivel del grupo de anuncios, puedes controlar qué formatos mostrar con el parámetro de configuración vertical_ads_format_setting y definir un conjunto de reglas de grupos de artículos para segmentar un subconjunto de tus entidades del feed de datos de anuncios verticales. Además, ahora los informes se pueden segmentar por AdFormatType y por dimensiones del feed de datos de anuncios verticales.

Video

v22.1 (25/2/2026)

Se agregó la siguiente función nueva en la versión 22.1.

Administración de la cuenta

  • Se agregó el campo contains_eu_political_advertising al recurso Customer. Este 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

  • Se agregó Campaign.missing_eu_political_advertising_declaration para admitir 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, se agregaron las siguientes funciones y actualizaciones nuevas.

Recursos

  • Se agregó LANDING_PAGE_PREVIEW como un nuevo tipo de campo de recurso de imagen.
  • Se introdujo AssetGenerationService (beta):
    • Este servicio permite generar recursos de texto y de imagen con IA generativa. En un principio, este servicio solo estará disponible para un conjunto limitado de participantes de la versión beta cerrada.
    • GenerateText: Genera texto basado en entradas como la URL final, las instrucciones de formato libre, las palabras clave y el contexto de la campaña existente.
    • GenerateImages: Genera imágenes basadas en entradas como la URL final, instrucciones de formato libre, el contexto de la campaña existente o la recontextualización de imágenes de productos existentes.
    • Los errores durante la generación de recursos se devuelven con códigos de AssetGenerationErrorEnum.

Campañas

Generación de demanda

General

  • Se agregó un límite de 10,000 operaciones por solicitud de AddBatchJobOperations.
  • Se actualizó el control del campo page_size en ListBatchJobResultsRequest:
    • Si page_size no está configurado o es 0, ahora se establece de forma predeterminada en el máximo de 1,000 (anteriormente, se devolvía INVALID_PAGE_SIZE).
    • Si page_size supera los 1,000, la API ahora devuelve un error INVALID_PAGE_SIZE (antes se limitaba de forma silenciosa a 1,000).
  • Se agregó un nuevo código de error: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED para indicar cuándo se superó el límite de tasas de activación del perfil de pagos.

Máximo rendimiento

  • Se agregaron nuevos valores de AssetAutomationType para las campañas de máximo rendimiento:
    • GENERATE_IMAGE_ENHANCEMENT: Permite la creación automática de imágenes mejoradas, como el recorte automático. Habilitada de forma predeterminada.
    • GENERATE_IMAGE_EXTRACTION: Habilita la obtención automática de imágenes de las URLs finales. De forma predeterminada, se utiliza el parámetro de configuración de la extensión de imagen dinámica a nivel de la cuenta.
  • Se quitó AssetPerformanceLabel para las campañas de máximo rendimiento.
  • La funcionalidad del Campaign.url_expansion_opt_out quitado ahora se administra configurando el AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION en AssetAutomationSetting.
  • Se agregaron segmentos nuevos para las campañas de máximo rendimiento. Cada uno de estos segmentos solo está disponible para las campañas de máximo rendimiento y no devolverá datos cuando se seleccione cualquier otro tipo de campaña.

Planificación

Informes

Objetivos unificados

  • Se agregó compatibilidad con los objetivos de retención de clientes para optimizar la reactivación de clientes existentes.

Video

v21.1 (2026-02-25)

Se agregó la siguiente función nueva en la versión 21.1.

Administración de la cuenta

  • Se agregó el campo contains_eu_political_advertising al recurso Customer. Este 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

  • Se agregó Campaign.missing_eu_political_advertising_declaration para admitir consultas y filtros de campañas que no tienen declaraciones sobre si contienen publicidad política segmentada para la UE.

v21 (2025-08-06)

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

IA Max para campañas de Búsqueda

  • Ahora puedes usar el campo ai_max_setting.enable_ai_max del objeto Campaign para habilitar IA Max para campañas de Búsqueda. IA Max para campañas de Búsqueda amplía el alcance de una campaña de Búsqueda a través de la concordancia con términos de búsqueda y permite controlar si se publican los controles de segmentación y de creatividad cuando se establecen. Los controles de automatización de recursos de texto y de listas de marcas que se establecieron en solicitudes de versiones anteriores seguirán vigentes hasta que se active y desactive explícitamente IA Max para campañas de Búsqueda. Se puede usar Campaign.ai_max_setting.bundling_required para determinar si se debe habilitar IA Max para campañas de Búsqueda para respetar o modificar los controles de automatización de recursos de texto y de listas de marcas. Se puede usar AdGroup.ai_max_ad_group_setting.disable_search_term_matching para inhabilitar la concordancia con términos de búsqueda cuando una campaña principal haya habilitado IA Max para campañas de Búsqueda. Consulta nuestra entrada de blog Desbloquea un rendimiento de nivel superior con IA Max para campañas de Búsqueda.

  • Se agregó CampaignError.AI_MAX_MUST_BE_ENABLED, que se arroja para las campañas de Búsqueda cuando habilitas FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION sin habilitar IA Max para campañas de Búsqueda en la campaña.

  • Se agregó compatibilidad para aplicar controles de segmentación a nivel del grupo de anuncios en las campañas potenciadas por IA Max de Búsqueda. Ahora puedes agregar los siguientes criterios a los grupos de anuncios:

    • Lista de marcas
    • Ubicaciones
    • Páginas web (reglas de URL)
  • Se agregó ai_max_search_term_ad_combination_view para generar informes sobre el rendimiento de las combinaciones de términos de búsqueda, títulos y páginas de destino. En esta vista, se muestran las búsquedas que activaron tus anuncios y el rendimiento de esas combinaciones específicas. En una versión futura, se incluirá una vista adicional que también incluirá datos de las campañas de máximo rendimiento. Si deseas evitar migrar tu implementación para obtener datos de las campañas de máximo rendimiento, considera esperar a esa versión.

  • Se agregó AI_MAX como un valor nuevo para el segmento search_term_match_type.

Recursos

Campañas

Conversiones

  • Se agregó ENGAGED_VIEW como un valor nuevo para el segmento conversion_attribution_event_type.

  • Los clientes ya no tendrán acceso al modo debug_enabled en ConversionUploadService. Si este campo se establece en TRUE, antes se usaba para distinguir el error CLICK_NOT_FOUND de SUCCESS para las importaciones de conversiones avanzadas de clientes potenciales.

Generación de demanda

Cambios en la publicidad política de la UE

Estos cambios en la publicidad política de la UE también se implementaron en las versiones v19.2 y v20.1.

  • Se agregó Campaign.contains_eu_political_advertising. Este campo indica si tu campaña incluye contenido publicitario político segmentado para la Unión Europea. Si este campo se establece en CONTAINS_EU_POLITICAL_ADVERTISING, la campaña dejará de publicarse en la UE a partir del 22 de septiembre de 2025. Las llamadas a la API para crear una campaña nueva fallarán con un error FieldError.REQUIRED si no se configura este campo.

    En el caso de las campañas existentes, debes establecer el campo contains_eu_political_advertising antes de intentar cambiar la segmentación por proximidad, por ubicación o por grupo de ubicaciones, ya sea a nivel de la campaña o del grupo de anuncios. Las llamadas a la API para crear o actualizar estos criterios de campaña o de grupo de anuncios para las campañas existentes fallarán con un error de CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si la campaña no completó la autodeclaración.

    En las versiones v19.x y 20.x, aún no se aplica el requisito de establecer este campo, pero se aplicará en el futuro. Este cambio se anunciará con anticipación.

  • Las pruebas y los experimentos arrojarán un ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si las campañas del experimento no declararon por sí mismas si contienen publicidad política segmentada para la Unión Europea.

Máximo rendimiento

  • Para las campañas de máximo rendimiento nuevas, el valor predeterminado de Campaign.brand_guidelines_enabled ahora es true.

  • Se agregó el informe campaign_search_term_view. En esta vista, se ofrecen métricas de términos de búsqueda agregadas a nivel de la campaña. En esta vista, también se introduce la compatibilidad de las campañas de máximo rendimiento con los términos de búsqueda.

  • Se agregó PERFORMANCE_MAX como un valor nuevo para el segmento search_term_match_type.

Planificación

Informes

Video

Notas de la versión archivadas

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