En esta página, se proporcionan notas de la versión de la API de Google Bid Manager.
Versión más reciente de la API: v2
22 de septiembre de 2025
Problemas conocidos
Se descontinuarán tres valores de enumeración de Filter debido a su bajo uso, como se anunció anteriormente en el Centro de ayuda de Display & Video 360.
v2
Los siguientes
Filtersdejaron de estar disponibles:Valores de FilterFILTER_DFP_ORDER_IDFILTER_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1 de marzo de 2025
Problemas conocidos
Se descontinuará el informe de disponibilidad del inventario de TrueView de YouTube y las dimensiones relacionadas, como se anunció anteriormente en el Centro de ayuda de Display & Video 360.
v2
Los siguientes valores de enumeración dejaron de estar disponibles:
Enum Valores ReportTypeINVENTORY_AVAILABILITYLos siguientes filtros dejaron de estar disponibles:
Valores del filtro FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEOLas siguientes métricas dejaron de estar disponibles:
Valores de métricas METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 de noviembre de 2024
Nuevas funciones
Se inicia el FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. Esto permite incluir datos de menor confianza para las métricas con los siguientes prefijos:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Cuando se usa este filtro, se debe incluir una de las métricas pertinentes.
En el momento del lanzamiento, las búsquedas que no incluyan este filtro se establecerán de forma predeterminada en el comportamiento predeterminado anterior de incluir solo datos con un alto nivel de confianza. A partir del 4 de febrero de 2025, las búsquedas que no incluyan este filtro incluirán de forma predeterminada datos con menor confianza.
v2
Se agregaron los siguientes filtros:
Tipo de filtro Valores disponibles FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: Incluye datos con menor confianza. (Predeterminado después del 4 de febrero de 2025)1: Solo se incluyen los datos con un alto nivel de confianza. (Configuración predeterminada antes del 4 de febrero de 2025)
1 de octubre de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Descontinuación de la dimensión de informes del modelado de inventario anónimo (AIM)
Se descontinúa la dimensión FILTER_ANONYMOUS_INVENTORY_MODELING.
La creación o ejecución de recursos de Query con valores de baja en params.groupBy devuelve un error de 400.
Las métricas de DST/ROC (costos operativos regulatorios) y de costo total de medios se volvieron incompatibles con los informes de YOUTUBE.
Los siguientes valores de métricas ya no se pueden usar en los informes de YOUTUBE:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
Crear o ejecutar recursos de Query con un params.type de YOUTUBE y un valor de métrica pertinente en params.metrics devuelve un error de 400.
1 de mayo de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Baja de los informes de Atribución de ruta y Ruta completa
Se descontinuaron los informes de Atribución de ruta y Ruta completa. Recuperar o crear estos tipos de recursos Query y Report genera un error.
Se retirarán los siguientes valores de ReportType:
FULL_PATHPATH_ATTRIBUTION
El campo pathQueryOptions del objeto Options también se retirará.
28 de febrero de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Baja de los valores de las métricas de conversiones en dispositivos múltiples
Se descontinuarán las métricas de conversiones en dispositivos múltiples. Se incluyen los siguientes valores de métricas de la API de Bid Manager:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 de julio de 2022
Nuevas funciones
Se lanzó la API de Bid Manager v2.
Se realizaron cambios estructurales en la API, incluida la actualización del extremo del servicio y el cambio de nombre de los servicios y métodos.
Se actualizaron significativamente los recursos Query y Report quitando campos innecesarios, reorganizando los campos existentes y cambiando los tipos de campos. Esto incluye cambiar los tipos de campos para usar objetos con nombre en lugar de una definición general de "objeto anidado".
Se requieren consultas ad hoc en ejecución con el método queries.run en lugar de que se ejecuten automáticamente después de la creación.
Se reemplazó el parámetro de consulta queries.run asynchronous por synchronous.
Se simplificó la recuperación de informes a través de los siguientes cambios:
- Se agregó un método
queries.reports.get. - Se agregó un parámetro de consulta
orderByaqueries.reports.list. - La actualización del cuerpo de la respuesta de
queries.runde un objeto vacío a una instancia del recursoReportgenerado.
Se actualizaron los mensajes de error que devuelve la API para que sean más específicos y proporcionen soluciones más prescriptivas.
Sigue las instrucciones que se presentan en la Guía de migración a la versión 2 para migrar de la versión 1.1 a la versión 2.
v2
Se cambió el extremo del servicio:
Extremo de servicio v1 Extremo de servicio v2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comSe cambiaron los nombres de los servicios de la siguiente manera:
Servicio de versión 1 Servicio de v2 Búsquedas queries Informes queries.reports Se cambió el nombre de los métodos de la siguiente manera:
Método de la versión 1 Método de la versión 2 Queries.createquery queries.create Queries.deletequery queries.delete Queries.getquery queries.get Queries.listqueries queries.list Queries.runquery queries.run Reports.listreports queries.reports.list Se agregaron los siguientes métodos:
Servicio Método(s) queries.reports get Los siguientes métodos tienen un nuevo cuerpo de respuesta:
Método Nuevo objeto de cuerpo de respuesta queries.run Informe Se quitaron los siguientes campos:
Recurso Campos queries.listCuerpo de la respuestakind
queries.reports.listCuerpo de la respuestakind
Consulta kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
El tipo de objeto de los siguientes campos se cambió a lo siguiente:
Recurso Campos Tipo de objeto Consulta Informe RunQueryRequest Se agregaron los siguientes parámetros de consulta del método:
Método Parámetros de consulta queries.list orderBy queries.reports.list orderBy queries.run síncrono Se quitaron los siguientes parámetros de consulta del método:
Método Parámetros de consulta queries.create asíncrono queries.run asíncrono Se agregaron los siguientes valores de filtro:
Valor del filtro FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Se quitaron los siguientes valores de filtro:
Valor del filtro FILTER_TRUEVIEW_IAR_REGION Se agregaron los siguientes valores de métricas:
Valor de la métrica METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Problemas conocidos
Ninguno
Versiones anteriores
Para obtener información sobre las versiones anteriores de la API de Bid Manager para las versiones descontinuadas, consulta nuestras notas de la versión archivadas.