¿Te interesa compartir tus comentarios sobre la API de Google Ads? Regístrate para que te inviten a participar en la investigación sobre usuarios.

Se usó la API de Cloud Translation para traducir esta página.

Notas de la versión

v20 (4/6/2025)

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

Recursos

Se agregaron varias métricas y columnas de segmentos nuevas para el informe asset_group.

Columnas de métricas

Columnas de segmentos

Campañas

Se agregó compatibilidad para agregar y actualizar palabras clave negativas a nivel de la campaña en las campañas de máximo rendimiento.

Conversiones

Ahora puedes actualizar el campo google_ads_conversion_customer en un cliente existente para habilitar el seguimiento de conversiones de múltiples cuentas o cambiar su cuenta principal de seguimiento de conversiones existente a una cuenta de administrador diferente.
Se agregó el campo ClickConversion.user_ip_address. Google Ads no admite la coincidencia de direcciones IP para los usuarios finales del Espacio Económico Europeo (EEE), el Reino Unido (RU) o Suiza (CH). Agrega lógica para excluir de forma condicional el uso compartido de direcciones IP de usuarios de estas regiones. Asegúrate de proporcionar a los usuarios información clara y completa sobre los datos que recopilas en tus sitios, aplicaciones y otras propiedades, y obtén su consentimiento cuando lo exija la ley o cualquier política de Google aplicable. Consulta la página Acerca de las importaciones de conversiones sin conexión para obtener más información.

Generación de demanda

Se agregaron valores nuevos al segmento ad_network_type que permiten segmentar las campañas de generación de demanda por canal:
- MAPS
- GMAIL
- DISCOVER
Se agregaron métricas para las conversiones comparables con otras plataformas:

Recomendaciones

Se agregó el campo merchant_center_account_id a GenerateRecommendationsRequest para indicar cuándo se deben generar recomendaciones para la venta minorista, en lugar de las campañas de máximo rendimiento estándar.

Planificación

Se agregó AudienceInsightsDimension.YOUTUBE_LINEUP para reemplazar AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP en AudienceInsightsService y ContentCreatorInsightsService. Esta nueva dimensión te permite recuperar estadísticas y metadatos de las selecciones de contenido de YouTube Select (YTS). Se reemplazaron los objetos asociados con YOUTUBE_DYNAMIC_LINEUP, como DynamicLineupAttributeMetadata y AudienceInsightsDynamicLineup, para alinearse con la eliminación más amplia de las alineaciones dinámicas en Google Ads. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregaron AdditionalApplicationInfo y ApplicationInstance en AudienceInsightsService, ContentCreatorInsightsService y ReachPlanService. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se actualizaron AudienceInsightsService y ContentCreatorInsightsService para proporcionar estadísticas más detalladas. Ahora puedes segmentar los datos de los creadores de contenido por dispositivo con los nuevos segmentos AudienceInsightsDimension.DEVICE y AudienceInsightsAttribute.device en ambos servicios. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregaron métricas de video agregadas adicionales a GenerateCreatorInsightsResponse para un análisis más completo de los creadores de contenido: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count y is_brand_connect_creator. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregó sub_country_locations a GenerateCreatorInsightsRequest para ContentCreatorInsightsService. Esto permite especificar ubicaciones geográficas de subpaíses para definir mejor las búsquedas de estadísticas de creadores. El campo sub_country_locations solo se admite cuando se usa search_attributes oneof en el campo criteria. Si se proporciona sub_country_locations con otros tipos de criterios, la solicitud no será válida. Esto permite una segmentación geográfica más detallada y un análisis más detallado de las estadísticas de los creadores de contenido. Esta función solo está disponible para las cuentas incluidas en una lista de entidades permitidas.
Se agregó ReachPlanService.ListPlannableUserLists, que muestra listas de usuarios propias de un cliente, y se agregó UserListInfo a las opciones de segmentación por público en GenerateReachForecastRequest. Esto te permite recuperar listas de usuarios planificables para un cliente determinado y, luego, generar previsiones de alcance para las campañas segmentadas para esos públicos específicos. Estas mejoras mejoran la planificación del alcance personalizado, ya que incorporan tus datos de público de origen directamente en las previsiones. La previsión de alcance solo está disponible para las cuentas incluidas en la lista de entidades permitidas.

Videos

Se agregaron los anuncios de AdFormatType.PAUSE que se publican en videos orgánicos de YouTube en pantallas de TV, que se incluyen en los informes. Estos anuncios se muestran directamente junto al fotograma estático del video en la pantalla de pausa. Esto no incluye los anuncios de video de generación de demanda que se muestran en el panel de anuncios debajo o encima de un video orgánico pausado, que se registran en AdFormatType.INFEED.

v19.1 (16/04/2025)

Las siguientes funciones y cambios se agregaron en la versión 19.1.

Recursos

Se agregó un campo asset_coverage para AssetGroup que muestra información sobre brechas en tu grupo de recursos.
- Contiene un subcampo ad_strength_action_items que muestra una lista de acciones que puede realizar un anunciante para mejorar la calidad del anuncio de un grupo de recursos.

Campañas

Ahora puedes calificar o enviar comentarios sobre los clientes potenciales en las campañas de servicios locales. Como parte de este cambio, la versión 19.1
- Se agregó un nuevo servicio llamado LocalServicesLeadService. Puedes usar el método ProvideLeadFeedback para subir calificaciones y comentarios de los clientes potenciales.
- Se agregó un campo nuevo llamado lead_feedback_submitted a LocalServicesLead para ayudar a determinar si se enviaron comentarios a un cliente potencial.
Se agregó una nueva columna de métricas biddable_cohort_app_post_install_conversions para las campañas de aplicaciones.

Generación de demanda

Se introdujeron métodos adicionales en los servicios de planificación para admitir la generación de demanda.
Se agregó compatibilidad con los Controles de canal a nivel del grupo de anuncios para las campañas de generación de demanda. Puedes seleccionar una agrupación general predefinida de canales o un subconjunto de canales con el campo demand_gen_ad_group_settings. En la versión actual, se admiten los siguientes canales:
- Anuncio in-stream de YouTube
- In-feed de YouTube
- YouTube Shorts
- Descubre
- Gmail
- Display
Se expuso un nuevo tipo de activo para TALL_PORTRAIT_MARKETING_IMAGE. Este tipo de recurso se relaciona con el campo tall_portrait_marketing_images del formato de anuncio de varios recursos de generación de demanda.

Historial de cambios

Se agregó compatibilidad con tres tipos de recursos más en ChangeStatusResourceType:
- CAMPAIGN_BUDGET
- ASSET_SET
- CAMPAIGN_ASSET_SET
Puedes recuperar estos tres tipos más detallados del informe change_status.

Conversiones

Ahora puedes configurar el campo google_ads_conversion_customer mientras creas un cliente nuevo con la API de Google Ads. Anteriormente, este era un campo de solo lectura.
Ahora puedes especificar el tipo de cliente asociado con la conversión cuando subas conversiones sin conexión.
Se agregó un nuevo campo session_attributes para ClickConversion.

Anuncios de Servicios Locales

Se agregó una nueva RPC ProvideLeadFeedback a LocalServicesLeadService para proporcionar comentarios sobre la calidad de LocalServicesLead.
Se agregó un nuevo campo lead_feedback_submitted al recurso LocalServicesLead que confirma si se proporcionaron comentarios para un recurso específico.

Servicios de planificación

Se agregó compatibilidad con las previsiones mensuales de frecuencia objetivo en ReachPlanService.GenerateReachForecast.
- Los desarrolladores pueden configurar TargetFrequencyTimeUnit.MONTHLY en TargetFrequencySettings cuando usan el código de producto planificable TARGET_FREQUENCY para generar una previsión de alcance mensual de frecuencia objetivo.
Se agregó un nuevo método ReachPlanService.GenerateConversionRates, que permite a los anunciantes solicitar porcentajes de conversiones sugeridos para los productos planificables compatibles.
Previsión de la generación de demanda en ReachPlanService.GenerateReachForecast:
- Ahora los desarrolladores pueden solicitar previsiones de alcance para las campañas de generación de demanda. Los desarrolladores pueden usar el nuevo código de producto planificable DEMAND_GEN_MAX_CONVERSIONS para generar previsiones de alcance de generación de demanda.
- Se agregó un nuevo campo conversion_rate que permite a los desarrolladores que solicitan previsiones de alcance de generación de demanda proporcionar un porcentaje de conversiones. Los porcentajes de conversiones sugeridos se pueden recuperar con el nuevo método ReachPlanService.GenerateConversionRates. Este campo es obligatorio para las solicitudes de previsión de la generación de demanda. No es compatible con otros productos planificables.
- Se agregó un nuevo campo conversions a las previsiones que se muestran. Este campo contiene la cantidad de conversiones en un punto determinado de la curva de alcance. Las conversiones solo son compatibles con el producto planificable DEMAND_GEN_MAX_CONVERSIONS.

Recomendaciones

El nuevo campo ad_strength está disponible para ImprovePerformanceMaxAdStrengthRecommendation, que muestra la puntuación actual de calidad del anuncio del grupo de recursos asociado con la recomendación.

Compras

Ahora puedes anular las exclusiones de marca para los anuncios de Shopping en las campañas de máximo rendimiento. Esto se expone a través de un nuevo campo pmax_campaign_settings a nivel de la campaña y solo funciona para las campañas de máximo rendimiento para venta minorista. Se arrojará un nuevo error CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED si intentas configurar este campo para un tipo de campaña incompatible.

Videos

Se agregó compatibilidad de solo lectura para los anuncios de audio. Consulta el Centro de ayuda de Google Ads para obtener información sobre esta función. Estos cambios exponen lo siguiente:
- Un nuevo AdvertisingChannelSubType llamado YOUTUBE_AUDIO.
- Un nuevo AdGroupType llamado YOUTUBE_AUDIO.
- Una nueva enumeración de formatos de anuncios llamada YOUTUBE_AUDIO_AD y sus campos YouTubeAudioAdInfo correspondientes
Se agregaron métricas y segmentos nuevos para consultar las métricas de alcance con el ajuste demográfico. Como parte de estos cambios, sucederá lo siguiente:
- Se introdujeron dos columnas de métricas nuevas llamadas coviewed_impressions y primary_impressions.
- Se introdujeron dos segmentos nuevos, adjusted_age_range y adjusted_gender.
- Si se selecciona uno de los dos segmentos nuevos junto con un campo de métrica de alcance (coviewed_impressions, primary_impressions, unique_users o average_impression_frequency_per_user), también se debe seleccionar el otro segmento para recuperar estadísticas válidas para estas columnas.
- Actualmente, esta función solo está disponible para los clientes incluidos en la lista de anunciantes permitidos.

v19 (26/2/2025)

Se agregaron las siguientes funciones y cambios en la versión 19.

Administración de cuentas

Se agregaron los siguientes valores a CustomerError para tener en cuenta los próximos cambios:
- CREATION_DENIED_FOR_POLICY_VIOLATION
- CREATION_DENIED_INELIGIBLE_MCC

Anuncios

Se agregó DemandGenMultiAssetAdInfo.tall_portrait_marketing_images para admitir recursos de imagen vertical con una relación de aspecto de 9:16 en los anuncios de generación de demanda.

Recursos

(Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó compatibilidad con los recursos de mensajes a través de Asset.business_message_asset, BusinessMessageAsset y los siguientes enums y errores.
- Enumeraciones:
- Errores:
  - AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
  - ResourceLimitType
Se agregó AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW para admitir la generación automática de una vista previa de la página de destino.
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS ahora está habilitado de forma predeterminada para los anuncios responsivos de video de generación de demanda.
(Solo para cuentas incluidas en la lista de entidades permitidas; la lista de entidades permitidas está cerrada actualmente) Se agregaron Asset.app_deep_link_asset y AppDeepLinkAsset.

Conversiones

Objetivos de conversión
- LifecycleGoalValueSettings.high_lifetime_value ya no está en versión beta y ahora es mutable.
- Se agregó CustomerLifecycleGoal.owner_customer para mostrar el nombre del recurso del cliente propietario del objetivo del ciclo de vida del cliente.
ConversionActionType.SALESFORCE quedó obsoleto.

Feeds

Se quitaron todas las entidades relacionadas con el feed, como Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, etcétera. Los usuarios ahora deben usar assets para lograr el mismo propósito. Consulta las Notas de migración para obtener la lista de todas las entidades que se quitaron.

Hoteles y viajes

Se hicieron min_days y max_days de ValueRuleItineraryAdvanceBookingWindow un campo optional para permitir especificar 0 como valor. Esto admite la segmentación para las búsquedas de viajes que se realizan hoy.

Máximo rendimiento

Lineamientos de desarrollo de la marca (solo para cuentas incluidas en la lista de entidades permitidas)
- Se hizo que Campaign.brand_guidelines_enabled fuera mutable solo cuando se crea una campaña de máximo rendimiento.
- Esto es incompatible con las campañas de máximo rendimiento para objetivos de viajes.
- Para habilitar los lineamientos de desarrollo de la marca para las campañas de máximo rendimiento existentes, usa un CampaignService.EnablePMaxBrandGuidelines agregado recientemente. No se admite inhabilitar los lineamientos de desarrollo de la marca.
- Se agregaron Campaign.brand_guidelines y BrandGuidelines para permitir configurar los colores y la familia de fuentes de la marca.
- Nuevos valores de error:
  - BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
  - BrandGuidelinesMigrationError
- CampaignError
- BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
- BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
- BRAND_GUIDELINES_COLOR_INVALID_FORMAT
- BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
- BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
- CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
- CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
Se agregó AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS para admitir la generación automática de recursos de video mejorados para las campañas de máximo rendimiento.

Planificación

Se agregó ContentCreatorInsightsService.GenerateTrendingInsights (solo para cuentas incluidas en la lista de entidades permitidas), que permite a los usuarios ver temas de contenido del momento en YouTube para definiciones de público determinadas.
Se agregó GenerateCreatorInsightsRequest.country_locations[] para especificar los países en los que se deben buscar los criterios determinados.
Se agregó GenerateCreatorInsightsRequest.search_brand para especificar una marca y buscar creadores.
Se agregaron campos nuevos a YouTubeChannelInsights para proporcionar información adicional del canal para las solicitudes de search_channels:
- channel_url
- channel_description
- top_videos
Se agregaron nuevos campos de metadatos a AudienceInsightsAttributeMetadata:
- youtube_video_metadata
- user_interest_attribute_metadata
- knowledge_graph_attribute_metadata

Videos

Después del lanzamiento de DataLinkService.CreateDataLink, añadimos los siguientes métodos para permitir la mutación de vínculos de datos creados anteriormente:
- RemoveDataLink para quitar vínculos de datos en una cuenta de Google Ads
- UpdateDataLink para aceptar, rechazar y revocar vínculos de datos en una cuenta de Google Ads
Se quitó la compatibilidad con VIDEO_OUTSTREAM de las siguientes enums:

v18 (16/10/2024)

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

Administración de cuentas

Se agregó DataLinkService.CreateDataLink (solo para cuentas incluidas en la lista de entidades permitidas), que permite vincular una cuenta de Google Ads a los videos de creadores alojados en su canal de YouTube. La vinculación de videos permite que la cuenta de Google Ads publique anuncios en plataformas asociadas con videos de creadores.

Grupos de anuncios

Se agregó AdGroup.exclude_demographic_expansion, que te permite excluir los datos demográficos para que no se expandan cuando optimized_targeting_enabled sea true, una función que antes solo se admitía para las campañas de generación de demanda.

Anuncios

Se agregó AdGroupAd.ad_group_ad_asset_automation_settings, que permite habilitar o inhabilitar la generación automática de recursos en los anuncios.
Se agregaron los siguientes valores a AssetAutomationType:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
Se agregó AdNetworkType.GOOGLE_OWNED_CHANNELS, que usan los anuncios que se publican en canales de Google, como YouTube, Gmail y el feed de Descubre.

Recursos

Se cambió el nombre de AssetType.DISCOVERY_CAROUSEL_CARD a AssetType.DEMAND_GEN_CAROUSEL_CARD.

Campañas

Se agregó metrics.store_visits_last_click_model_attributed_conversions, que muestra la cantidad de visitas a tienda atribuidas por el modelo de último clic de una campaña.
Se agregaron las siguientes métricas relacionadas con las vistas de video para una campaña:
Se agregó metrics.results_conversions_purchase, que muestra las compras de conversión para los resultados de los objetivos unificados de una campaña.
Se cambió el valor predeterminado de DemandGenCampaignSettings.upgraded_targeting de false a true.

Criterio

Se agregó content_criterion_view, que muestra las métricas de rendimiento del contenido segmentado, como palabras clave, posiciones y temas, para las campañas de Display, de generación de demanda y de video.

Hoteles y viajes

Compatibilidad con los feeds de viajes en los anuncios de búsqueda
- Se agregó ClickType.TRAVEL_ASSETS para permitir la segmentación de métricas de los Feeds de viajes en anuncios de búsqueda.
- Se agregó AssetSetType.TRAVEL_FEED, que se puede usar para habilitar o inhabilitar el uso del Feed de viajes en anuncios de búsqueda.
(Solo para cuentas incluidas en la lista de entidades permitidas) Se agregó el itinerario de viaje como una nueva regla de valor de conversión con los siguientes campos y valores nuevos:
- ConversionValueRule.itinerary_condition con ValueRuleItineraryCondition, que permite especificar un período de reserva anticipada, una duración del itinerario y los días de la semana de inicio del viaje
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
Se agregaron los siguientes segmentos para los informes campaign y ad_group para permitir segmentar los datos de rendimiento en función de destinos específicos (ciudades, países y regiones) para las campañas de hoteles y de Búsqueda:

Servicios locales

PhoneCallDetails.call_recording_url estará vacío, en lugar de proporcionar una URL no válida, si no existe la grabación de la llamada para la conversación con el cliente potencial de los servicios locales.
Se agregó CategoryBid.target_cpa_bid_micro, que permite establecer el CPA objetivo de una categoría a través de Campaign.local_services_campaign_settings.

Máximo rendimiento

Compatibilidad con los lineamientos de desarrollo de la marca
- Se agregó Campaign.brand_guidelines_enabled, que muestra si los lineamientos de la marca están habilitados para una campaña de máximo rendimiento determinada. Si está habilitado, los recursos con field_type configurados en BUSINESS_NAME, LOGO y LANDSCAPE_LOGO deben vincularse como recursos CampaignAsset en lugar de recursos AssetGroupAsset.
- Se agregaron los errores CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED y CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, que indican que las campañas de máximo rendimiento con lineamientos de desarrollo de la marca habilitados no tienen los recursos CampaignAsset necesarios vinculados a la campaña.
- Cuando los lineamientos de desarrollo de la marca están habilitados, al menos un recurso con field_type configurado como BUSINESS_NAME y al menos uno con LOGO deben estar vinculados a la campaña como recursos CampaignAsset. Las campañas de máximo rendimiento para ventas en línea con un feed de productos deben cumplir con este requisito solo cuando hay recursos vinculados a los grupos de recursos de la campaña.
- Se agregaron los siguientes valores a AssetLinkError:
- BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, que se genera cuando se intenta vincular recursos de marca a las campañas como recursos CampaignAsset en lugar de recursos AssetGroupAsset en campañas de máximo rendimiento con lineamientos de marca no habilitados.
- Error BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, que se produce cuando se intenta vincular recursos de marca a las campañas como recursos AssetGroupAsset en lugar de recursos CampaignAsset en las campañas de máximo rendimiento con los lineamientos de la marca habilitados.
Se agregó performance_max_placement_view, que muestra las impresiones de las posiciones en las que se publicaron los anuncios de las campañas de máximo rendimiento.
Se agregó AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planificación

Se agregó un servicio nuevo con el método ContentCreatorInsightsService.GenerateCreatorInsights (solo para cuentas incluidas en la lista de entidades permitidas) que permite a los usuarios explorar estadísticas sobre los creadores principales de YouTube. Esto permite a los clientes buscar creadores a partir de una combinación de segmentación por público y por contenido, o estadísticas de creadores a partir de una lista de IDs de canales de YouTube.
Actualizaciones a AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Se movieron audience, baseline_audience y data_month a audience_definition.
- Se agregó audience_description para generar sugerencias de segmentación a partir de una descripción de texto de formato libre con IA generativa.
Se agregó AudienceInsightsService.GenerateTargetingSuggestionMetrics, que muestra las métricas de alcance potencial para combinaciones de segmentación por público determinadas.

Recomendaciones

Ahora se puede usar RecommendationService.GenerateRecommendations para generar recomendaciones sobre sugerencias de presupuestos optimizados durante la creación de la campaña. Para ello, incluye el tipo de recomendación CAMPAIGN_BUDGET en GenerateRecommendationsRequest.recommendation_types[]. Esto funciona para las campañas de máximo rendimiento y de Búsqueda.

Informes

Se reemplazaron los campos summary_row_setting y return_total_results_count de SearchGoogleAdsRequest por el campo search_settings, cuyo tipo es SearchSettings, con los siguientes campos:
- omit_results
- return_summary_row
- return_total_results_count
Se agregaron las siguientes métricas nuevas sobre los clics no válidos generales, como los que generan bots o rastreadores, y los que tienen patrones irregulares. Se pueden consultar con el informe campaign.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
Se agregaron los siguientes valores a QuotaError:
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION