Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Notas de la versión

Aquí puedes consultar los cambios que se realizaron en cada versión de la API de Data Manager.

30-7-2026 v1.8

Se agregó el método RemoveAllAudienceMembers a IngestionService para quitar o reemplazar todos los miembros del público de las listas de usuarios especificadas.
- Para comenzar, revisa la guía sobre cómo quitar a todos los miembros de un público para tu integración específica. Por ejemplo, consulta las guías de Segmentación por clientes para Google Ads o Display & Video 360.
Se agregó compatibilidad para mostrar advertencias detalladas durante la transferencia de eventos y públicos.
- Se agregó el campo field_warnings a IngestEventsResponse y IngestAudienceMembersResponse, que contiene una lista de objetos FieldWarning.
- Se agregó el recurso FieldWarning, que contiene una ruta de acceso reason (WarningReason), description y field.
- Se agregó la enumeración WarningReason para definir los motivos de las advertencias, como las variables personalizadas que no están habilitadas o los IDs de comerciante que faltan en los datos del carrito.
Se agregó compatibilidad para enviar campos de dirección adicionales para la transferencia de eventos de Google Analytics.
- Se agregaron los campos address_line, city y administrative_area a AddressInfo (que se usa en UserData).
Se agregaron los motivos de error INVALID_REMOVE_AS_OF_TIME y REQUIRED_PREREQUISITE_LINK_MISSING a la enumeración ErrorReason.

28-5-2026 v1.7

Se agregó compatibilidad para enviar eventos de conversión sin conexión a los productos de Google Marketing Platform, incluidos Campaign Manager 360, Search Ads 360 y Display & Video 360, con un IngestEventsRequest.
- Se agregó FLOODLIGHT_CONFIG al enum AccountType para admitir destinos de Floodlight.
- Se agregaron los campos dclid, impression_id, match_id y encrypted_user_ids a AdIdentifiers.
- Se agregó el campo conversion_count al recurso Event para admitir el seguimiento de las cantidades de conversiones.
Consulta la guía para enviar eventos para comenzar o obtén información sobre cómo actualizar desde la API de Campaign Manager 360.
Se agregó el campo composite_data al recurso AudienceMember, que acepta un objeto CompositeData y te permite combinar varios tipos de identificadores, como UserData y IpData. Consulta Datos compuestos para obtener más información.
- Se agregaron los nuevos estados IngestCompositeDataStatus y RemoveCompositeDataStatus que incluyen diagnósticos (record_count y data_type_counts) para las solicitudes de miembros del público que usan CompositeData.
Se agregó compatibilidad con la transferencia de direcciones IP para la Segmentación por clientes de Google Ads enviando IpData en datos compuestos.
Se agregaron los nuevos motivos de error FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED y INSIGHTS_MISSING_FOR_DIMENSION a la enumeración ErrorReason.
Se agregaron nuevos valores de diagnóstico a ProcessingErrorReason para proporcionar comentarios más detallados sobre las fallas durante la transferencia de eventos.

7 de mayo de 2026, v1.6

Se agregó compatibilidad para enviar conversiones de ventas en la tienda de Google Ads con un IngestEventsRequest. Para usar esta función, tu cuenta de Google Ads debe cumplir con ciertos requisitos de elegibilidad.
- Se agregó el campo event_location a Event, que admite proporcionar un store_id. físico.
- Se agregó el campo third_party_user_data a Event, lo que permite que los datos transferidos se marquen de forma explícita como propiedad de un tercero.
  - Solo los socios de datos pueden completar este campo.
- Se agregaron los siguientes campos al recurso Item:
  - merchant_id
  - merchant_feed_label
  - merchant_feed_language_code
  - conversion_value
  - custom_variables (acepta una lista de objetos ItemCustomVariable)
- Consulta las siguientes guías para comenzar:
  - Cómo actualizar desde Google Ads
  - Envía eventos
Se agregó compatibilidad para enviar a Google Analytics cualquier evento web o de app que no sea un evento reservado.
- Se agregó el campo app_instance_id al recurso Event.
- Se agregaron campos a DeviceInfo para proporcionar metadatos sobre el dispositivo del usuario.
- Se agregó el campo mobile_device_id a AdIdentifiers.
- Se agregó el campo event_location a Event para capturar campos como city, subdivision_code, region_code, subcontinent_code y continent_code.
- Consulta las siguientes guías para comenzar:
Se agregó compatibilidad para enviar cualquier evento con un ID de transacción a los flujos de datos de aplicación y web como fuente de datos adicional para tus implementaciones de etiquetas o del SDK de Google Analytics para Firebase (GA4F).
- Esta función se limita a las propiedades de Google Analytics que se encuentran en una lista de entidades permitidas. Completa este formulario si te interesa agregar tu propiedad a la lista de entidades permitidas.
Se agregó el campo coupon_codes a CartData para hacer un seguimiento de todos los códigos de cupón aplicados al carrito para los eventos enviados a Google Ads y Google Analytics.
- Para los casos de uso de canje de cupones en Google Ads, utiliza el tipo de conversión OFFLINE_PROMOTION_REDEMPTION.
Se agregó un nuevo permiso de OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, para los métodos relacionados con la creación, la búsqueda y la eliminación de vínculos de socios.
Se agregaron valores nuevos a la enumeración ErrorReason para admitir la validación detallada de las ventas en la tienda y la transferencia de eventos de Google Analytics.
Se agregaron los campos youtube_members_count y gmail_members_count al recurso SizeInfo.

2026-03-26

Se agregó EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED a la enum ErrorReason.

Para cumplir con el Reglamento de Publicidad Política de la Unión Europea (PAR de la UE), Google exige que todos los clientes declaren si sus anuncios se consideran políticos según el PAR de la UE. Obtén información sobre cómo se define un anuncio político de la UE y las restricciones de Google sobre los anuncios políticos en la UE.

A partir del 1 de abril de 2026, es posible que se restrinjan o fallen las siguientes operaciones en las cuentas que no tengan esta declaración, con el error EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.
- UserListService (create, update y delete)
- IngestionService (ingestAudienceMembers)
Para resolver el error, los anunciantes deben proporcionar la declaración obligatoria en la IU de Google Ads. Obtén más información para confirmar los anuncios en toda la cuenta.
Se agregó INVALID_MERCHANT_ID a la enum ErrorReason.

17-02-2026 v1.5

La API de Data Manager ahora admite todo el flujo de trabajo de extremo a extremo para administrar públicos, lo que incluye la creación, la transferencia y la recuperación de públicos.

Se agregaron el recurso UserList y UserListService para permitir la creación, la recuperación, la actualización y la eliminación de listas de usuarios.
- Consulta las guías de Google Ads o Display & Video 360 para obtener un recorrido completo sobre cómo crear, propagar y verificar públicos de Segmentación por clientes con la API de Data Manager.
- Consulta las guías de actualización de Google Ads o Display & Video 360 para conocer los pasos de migración.
Se agregó compatibilidad para enviar el ID de usuario a través de la transferencia de miembros del público, lo que permite su uso con la Segmentación por clientes en Google Ads.
- Se agregó UserIdData a AudienceMember.
- Se agregaron IngestUserIdDataStatus y RemoveUserIdDataStatus a los estados que muestra el método RetrieveRequestStatus. Usa estos campos para recuperar información de diagnóstico sobre la transferencia y eliminación de IDs de usuario.
Se agregaron el recurso PartnerLink y PartnerLinkService para crear y administrar vínculos entre las cuentas de anunciantes y de socios de datos.
- Consulta las guías de vínculos de socios para comenzar.

2026-02-10

El envío de conversiones con varias fuentes de datos para mejorar el rendimiento y la solidez de los datos ahora está disponible de forma general para todas las cuentas de Google Ads.

Esta función solo está disponible para las propiedades de Google Analytics que se encuentran en una lista de entidades permitidas. Completa el formulario si te interesa agregar tu propiedad de Google Analytics a la lista de entidades permitidas.

5 de noviembre de 2025, v1.4

Se agregó compatibilidad para enviar eventos de Google Analytics purchase como una fuente de datos adicional para tus conversiones basadas en etiquetas, lo que te permite maximizar los indicadores de interacción con el anuncio y fortalecer tus datos y tu rendimiento general.
- Se agregó GOOGLE_ANALYTICS_PROPERTY a la enum AccountType.
- Se agregaron varios campos a Event:
  - event_name
  - client_id
  - user_id
  - additional_event_parameters
- Se agregó additional_user_properties a UserProperties.
Obtén más información para enviar eventos de Google Analytics purchase y asignar parámetros de eventos y propiedades del usuario de Google Analytics a sus equivalentes de la API de Data Manager en la guía de eventos.
Se agregó AwsWrappedKeyInfo para admitir el uso de claves de encriptación del Servicio de administración de claves de AWS.
Se agregaron los siguientes valores de enumeración a ErrorReason:
- EVENT_TIME_INVALID
- FIELD_VALUE_TOO_LONG
- INVALID_EVENT_NAME
- INVALID_PROPERTY_TYPE
- INVALID_REQUEST_ID
- INVALID_STREAM_TYPE
- LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
- MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
- NOT_ALLOWLISTED
- OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
- RESERVED_NAME_USED
- TOO_MANY_ELEMENTS
- UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
- UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

6 de octubre de 2025, v1.3

La API del Administrador de datos ahora está disponible de forma general para todos los usuarios.

El envío de conversiones con varias fuentes de datos para mejorar el rendimiento y la solidez de los datos sigue estando disponible solo para las cuentas que se encuentran en una lista de entidades permitidas. Completa el formulario si te interesa agregar tu cuenta.

Completa el formulario de interés para socios para expresar tu interés en convertirte en socio de datos.
Se agregó el método RetrieveRequestStatus para recuperar información de diagnóstico de las solicitudes de transferencia de eventos y públicos.
El campo product de ProductAccount y la enumeración Product dejaron de estar disponibles. En su lugar, usa el campo account_type y la nueva enumeración AccountType.
Se agregó compatibilidad para especificar el destination de cada AudienceMember en un IngestAudienceMembersRequest. Usa esta función para enviar datos de público a varios destinos distintos en una sola solicitud.
Los públicos transferidos con la API ahora son aptos para la segmentación una vez que tienen, al menos, 100 miembros. Anteriormente, el umbral era de mil miembros.
El transaction_id de un Event ahora es opcional cuando se envían conversiones sin conexión o conversiones avanzadas de clientes potenciales. El transaction_id sigue siendo obligatorio cuando se envían conversiones sin conexión como una fuente de datos adicional para mejorar el rendimiento y la solidez de los datos.

6 de agosto de 2025, v1.2

Se agregó compatibilidad para enviar conversiones sin conexión y conversiones avanzadas de clientes potenciales a destinos de Google Ads con el método IngestEvents. Consulta la guía de encriptación actualizada para saber cómo configurar la encriptación para estas conversiones.
Se agregaron los valores APP, IN_STORE, PHONE y OTHER a la enumeración EventSource. Se requiere un event_source para las conversiones sin conexión y las conversiones avanzadas de leads.
Se agregó el campo user_properties a Event. Establece este campo en un objeto UserProperties para agregar información evaluada por el anunciante sobre un usuario cuando se produjo el evento.
Se agregó un campo repetido destination_references a CustomVariable. Usa este campo para aplicar un valor de variable personalizado solo a un subconjunto de los destinos de un Event.
Se agregaron los siguientes errores para las conversiones sin conexión y las conversiones avanzadas de clientes potenciales:
- DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
- DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
- DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

25/6/2025 v1.1

Se agregó el método IngestEvents a IngestionService. Usa IngestEvents como una fuente de datos adicional para tus conversiones basadas en etiquetas, para maximizar los indicadores de interacción con el anuncio y fortalecer tus datos y el rendimiento general.

2-4-2025 v1.0

Primera versión de la API de Data Manager, con compatibilidad para enviar datos de público a Google Ads y Display & Video 360.
Se agregó compatibilidad con gRPC y REST.
Se agregó IngestionService con los métodos IngestAudienceMembers y RemoveAudienceMembers para administrar los miembros del público con los siguientes tipos de datos:
Los públicos administrados con la API de Data Manager solo son aptos para la segmentación si tienen, al menos, 1,000 miembros.

Notas de la versión Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.