¿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

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. Ahora, los usuarios deben usar recursos 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 viaje.
- 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 buscarán 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, generación de demanda y 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 las 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 los 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 determinada.
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á habilitada, 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 los lineamientos 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 desarrollo de la 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 bien 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_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07/08/2024)

En la versión 17_1, se agregaron las siguientes funciones y actualizaciones nuevas:

Recursos

AdGroupAdService.RemoveAutomaticallyCreatedAssets() te permite quitar recursos creados automáticamente específicos vinculados a los anuncios de búsqueda responsivos.

Públicos

Valores de enumeración nuevos en UserListCustomerTypeCategory:
- LOYALTY_TIER_1_MEMBERS
- LOYALTY_TIER_2_MEMBERS
- LOYALTY_TIER_3_MEMBERS
- LOYALTY_TIER_4_MEMBERS
- LOYALTY_TIER_5_MEMBERS
- LOYALTY_TIER_6_MEMBERS
- LOYALTY_TIER_7_MEMBERS

Campañas

ShareablePreviewService.GenerateShareablePreviews() genera las URLs (shareable_preview_url en la respuesta) para las vistas previas de anuncios que se pueden compartir de los grupos de recursos habilitados y detenidos.
- El campo expiration_date_time indica la fecha de vencimiento de las URLs en la respuesta.
- Si se produce un error, el método mostrará partial_failure_error en lugar de las URLs.

Historial de cambios

Nuevo tipo de recurso de estado de cambio: ASSET_GROUP.

Conversiones

Nuevo campo de segmento para la versión de SKAdNetwork: segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary, que expone los diagnósticos de carga de conversiones a nivel de la acción de conversión.
Las siguientes métricas se agregan a los informes de diagnósticos sin conexión para indicar la cantidad de conversiones subidas que aún se están procesando:
- offline_conversion_upload_client_summary
  - pending_event_count
  - pending_rate
- offline_conversion_upload_conversion_action_summary:
  - pending_count

Planificación

AudienceInsights.GenerateAudienceOverlapInsights(), que acepta un atributo principal de entrada y una colección de atributos de público, y muestra las estimaciones de la superposición del alcance potencial de YouTube entre el atributo principal y los atributos de público.

Informes

Compatibilidad con la segmentación de per_store_view según segments.date

Videos

Compatibilidad para recuperar información relacionada con las siguientes estrategias de ofertas estándar para campañas de video mediante informes, como ad_group y campaign:
- Campaign.fixed_cpm (CPM fijo (costo por mil impresiones))
- Campaign.target_cpv (CPV objetivo (costo por vista))
Campaign.video_campaign_settings, que te permite determinar en qué inventarios se pueden mostrar los anuncios de video con los siguientes campos de informes:
segments.ad_format_type, que te permite segmentar los siguientes informes según el tipo de formato de anuncio de video:

v17 (5/6/2024)

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

Anuncios

Se quitó AdService.getAd. Esto alinea AdService con otros servicios de la API de Google Ads. Consulta Cómo recuperar objetos para conocer la forma recomendada de recuperar anuncios y otros tipos de recursos.
Se agregaron más validaciones para ImageAdInfo.image_asset en relación con las dimensiones y el formato. Si la imagen no es válida, es posible que se muestren los siguientes errores:
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

Recursos

Se agregó una nueva enumeración: ClickType.AD_IMAGE
Se agregaron los siguientes informes nuevos con métricas nuevas para las campañas de máximo rendimiento y de Búsqueda:
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

Públicos

Se agregó OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Trabajos por lotes

Se agregó BatchJobError.REQUEST_TOO_LARGE, que se arrojará cuando el AddBatchJobOperationsRequest enviado sea mayor que 10484504 bytes.
Se agregó compatibilidad para configurar MutateOperation.asset_group_operation cuando se usa BatchJobService. Esto te permite usar el procesamiento por lotes para crear y administrar campañas de máximo rendimiento completas. Consulta nuestra nueva guía exclusiva.

Campañas

Se cambió el nombre de Discovery a Generación de Demanda en todos los campos, enums y errores de todos los recursos de la API de Google Ads, como las campañas, los anuncios y los recursos. Por ejemplo, AdvertisingChannelType.DISCOVERY ahora es AdvertisingChannelType.DEMAND_GEN.
Se agregó Campaign.keyword_match_type para que puedas establecer el tipo de concordancia de palabras clave para todas las palabras clave de una campaña.

Conversiones

Para las conversiones de SKAdNetwork,
- Se cambió el nombre de segments.sk_ad_network_conversion_value a segments.sk_ad_network_fine_conversion_value.
- Se agregó segments.sk_ad_network_redistributed_fine_conversion_value.
Las siguientes métricas ahora se muestran con la respuesta, incluso cuando son cero. Esto las hace coherentes con otras métricas.

Criterios

Se agregó a los siguientes campos de AdGroupCriterion para mostrar si el criterio del grupo de anuncios se publica o los motivos por los que no se publica:
- primary_status
- primary_status_reasons
Se agregó compatibilidad con metrics.search_impression_share para gender_view.
Se agregó compatibilidad con metrics.phone_calls para keyword_view.

Servicios locales

Se agregó LocalServicesLeadService.AppendLeadConversation(), que se usa para agregar un nuevo LocalServicesLeadConversation a LocalServicesLead, que envía los mensajes a los usuarios a través de los canales adecuados, como SMS, según cómo se haya creado el cliente potencial.
- El tamaño de AppendLeadConversationRequest.conversations se limita a 1,000.
- Solo se puede especificar LocalServicesLead con lead_type establecido en LeadType.MESSAGE en Conversation.local_services_lead.
Se agregaron nuevos valores de enumeración a ConversationType:
- WHATSAPP para representar una conversación introducida a través de WhatsApp.
- ADS_API para representar una conversación introducida con el nuevo método LocalServicesLeadService.AppendLeadConversation()
Se agregaron los siguientes campos nuevos a local_services_verification_artifact:
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

Informes

Ahora puedes seleccionar solo los campos relacionados con un producto vinculado cuando consultas product_link. Si seleccionas varios campos de varios productos vinculados, se mostrará QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Por ejemplo, product_link.advertising_partner.customer y product_link.data_partner.data_partner_id no se pueden seleccionar en la misma consulta.
Si pasas un page_size a GoogleAdsService.Search, se generará un error RequestError.PAGE_SIZE_NOT_SUPPORTED.

Compras

Se agregó un nuevo informe shopping_product, que corresponde a la página Productos de la IU de Google Ads. Admite mostrar datos relacionados con el estado actual de los productos de las cuentas de Google Merchant Center vinculadas a una cuenta de Google Ads.
- Puedes filtrar las métricas del informe shopping_product con segments.date cuando usas GoogleAdsService.Search o GoogleAdsService.SearchStream. No se permite la segmentación por fecha, por lo que se mostrará un error ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Objetivos unificados

Se agregó UserListCustomerTypeService.MutateUserListCustomerTypes() para configurar los tipos de clientes del público.
Se quitó CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Para configurar la configuración del público de los objetivos de ciclo de vida del cliente, usa UserListCustomerTypeService.MutateUserListCustomerTypes() en su lugar.
- Para adjuntar o desasociar una lista de usuarios, configura UserListCustomerType.customer_type_category como UserListCustomerTypeCategory.PURCHASERS para incluirla o excluirla de una definición de cliente existente para los objetivos del ciclo de vida del cliente, respectivamente. Consulta Cómo segmentar tus públicos para obtener más información.

Videos

Se agregaron los siguientes valores a ContentLabelType. Puedes excluir estos ContentLabelTypes a nivel del cliente:
- BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
- BRAND_SUITABILITY_GAMES_FIGHTING
- BRAND_SUITABILITY_GAMES_MATURE
- BRAND_SUITABILITY_HEALTH_SENSITIVE
- BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
- BRAND_SUITABILITY_NEWS_RECENT
- BRAND_SUITABILITY_NEWS_SENSITIVE
- BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
- BRAND_SUITABILITY_POLITICS
- BRAND_SUITABILITY_RELIGION
Se agregó AdVideoAsset.ad_video_asset_info para admitir preferencias de inventario para recursos de video cuando se crea DemandGenVideoResponsiveAdInfo.
(Solo para cuentas incluidas en la lista de entidades permitidas) Se hizo Campaign.video_brand_safety_suitability mutable.

Notas de la versión archivadas

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