En esta página, se proporcionan notas de la versión para las versiones descontinuadas de la API de Display & Video 360.
Navega a nuestra página principal de notas de la versión para ver todas las versiones publicadas.
4 de diciembre de 2024
Nuevas funciones
Se agregó compatibilidad con los valores de Exchange de Core y Tubi.
Se aumentó el tamaño máximo de página permitido para firstAndThirdPartyAudiences.list de 200 a 5000. Actualiza el parámetro pageSize de tus solicitudes firstAndThirdPartyAudiences.list para optimizar aún más el uso de la cuota.
v3
Se agregaron los siguientes valores de enumeración:
Enum Valores ExchangeEXCHANGE_COREEXCHANGE_TUBISe aumentó el tamaño máximo de página para los siguientes métodos de lista:
Método Nuevo tamaño máximo de página firstAndThirdPartyAudiences.list5000
22 de octubre de 2024
Nuevas funciones
Se agregó compatibilidad con el objetivo de rendimiento de costo por vista.
Se agregó la capacidad de establecer y recuperar la segmentación de dispositivos conectados.
Se agregaron nuevos parámetros de configuración de seguridad de la marca de Adloox en third-party verifier targeting.
Se agregó compatibilidad para descargar archivos de datos estructurados v8, que actualmente se encuentran en versión beta cerrada.
v3
Se agregaron los siguientes campos:
Objeto Campos AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentSe agregaron los siguientes valores de enumeración:
Enum Valores DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Valores obsoletos
Se quitó la compatibilidad con la versión 5.5 del SDF, ya que dejó de estar disponible el 3 de octubre de 2024.
v3
Los siguientes valores de enumeración dejaron de estar disponibles:
Enum Valores SdfVersionSDF_VERSION_5_5
15 de agosto de 2024
Nuevas funciones
Se agregó compatibilidad con el tipo Exchange de Netflix.
v3
Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_NETFLIX
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_NETFLIX
15 de julio de 2024
Nuevas funciones
En la versión 3, se agregó compatibilidad para descargar archivos de datos estructurados de partidas y grupos de anuncios en formato de QA.
v3
Se agregaron los siguientes campos:
Recurso Campos IdFilter Se agregaron los siguientes valores de enumeración:
Enum Valores FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 de junio de 2024
Nuevas funciones
Se agregó compatibilidad para administrar la segmentación por palabras clave asignada a nivel del anunciante.
Se agregó un nuevo campo optimizationObjective al recurso del pedido de inserción. optimizationObjective solo está disponible para los clientes incluidos en la lista de entidades permitidas.
v3
Se agregaron los siguientes campos:
Recurso Campos InsertionOrder Ahora, los siguientes métodos admiten los siguientes tipos de segmentación:
Tipo de orientación Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Ahora, los siguientes métodos admiten los siguientes tipos de segmentación:
Tipo de orientación Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 de mayo de 2024
Nuevas funciones
Se agregó compatibilidad con la versión 7.1 de los archivos de datos estructurados (SDF).
v3
Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion SDF_VERSION_7_1
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion SDF_VERSION_7_1
23 de abril de 2024
Nuevas funciones
Se agregó compatibilidad con nuevos tipos de KPI, intercambios y plataformas de aplicaciones.
v3
Se agregaron los siguientes campos:
Recurso Campos Kpi Se agregaron los siguientes valores de enumeración:
Enum Valores AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Intercambio EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Intercambio EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 de febrero de 2024
Nuevas funciones
Se agregó la capacidad de quitar explícitamente miembros de los públicos de Segmentación por clientes.
Se agregó compatibilidad para segmentar anuncios en nuevos intercambios.
v3
Se agregaron los siguientes campos:
Recurso Campos firstAndThirdPartyAudiences.editCustomerMatchMembers Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Se agregaron los siguientes campos:
Recurso Campos firstAndThirdPartyAudiences.editCustomerMatchMembers Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 de enero de 2024
Nuevas funciones
Se agregó la capacidad de recuperar actividades de Floodlight a través de un nuevo servicio floodlightGroups.floodlightActivities.
Se agregó un campo nuevo que indica si una línea de pedido de YouTube y socios incluye inventario de Google TV en su segmentación.
Se agregó un campo nuevo para retransmitir la hora del último acceso de un usuario de Display & Video 360.
v3
Se agregaron los siguientes métodos:
Servicio Métodos floodlightGroups.floodlightActivities Se agregaron los siguientes campos:
Recurso Campos Usuario YoutubeAndPartnersInventorySourceConfig
v2
Se agregaron los siguientes métodos:
Servicio Métodos floodlightGroups.floodlightActivities Se agregaron los siguientes campos:
Recurso Campos Usuario YoutubeAndPartnersInventorySourceConfig
14 de noviembre de 2023
Nuevas funciones
Se agregó compatibilidad para pasar el consentimiento del usuario final cuando se suben miembros del público de la Segmentación por clientes en todas las versiones activas.
v3
Se agregaron los siguientes campos:
Recurso Campos ContactInfoList MobileDeviceIdList
v2
Se agregaron los siguientes campos:
Recurso Campos ContactInfoList MobileDeviceIdList
31 de octubre de 2023
Nuevas funciones
La versión 3 dejó de estar en versión beta pública y pasó a estar disponible para el público en general.
Se cambió el nombre de un valor de enumeración AdGroupFormat en la versión 3 para reflejar con mayor precisión el formato pertinente.
Se agregó compatibilidad con los archivos de datos estructurados v7 con la incorporación del valor de enumeración SDF_VERSION_7 en las versiones 2 y 3.
v3
Se quitaron los siguientes valores de enumeración:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_ACTION
Se agregaron los siguientes valores de enumeración:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion SDF_VERSION_7
2 de octubre de 2023
Nuevas funciones
Se lanzó la versión 3 en versión beta pública, que incluye los siguientes cambios:
- Capacidad para administrar por completo las listas de ubicaciones de proximidad, lo que permite usar el servicio de
advertisers.locationLists.assignedLocationspara crear y borrar ubicaciones asignadas a recursos deTARGETING_LOCATION_TYPE_PROXIMITYLocationList - Un nuevo campo booleano
enableOptimizedTargetingque reemplaza el campotargetingExpansionLevelen el objetoTargetingExpansionConfig. - El requisito del campo
billingConfigen el recursoAdvertiser, que se debe incluir cuando se realizan solicitudesadvertisers.create, y un nuevo campobillingConfigen el recursoPartner - Nuevos recursos
AdGroupyAdGroupAdque reemplazan los recursosYoutubeAdGroupyYoutubeAdGroupAden la versión 2.
Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 2 a la versión 3.
Se agregó compatibilidad con 3 valores nuevos de LineItemType, un YoutubeAndPartnersBiddingStrategyType nuevo y un PartnerCostType nuevo en las versiones 2 y 3.
v3
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Se quitaron los siguientes métodos:
Servicio Métodos advertisers.manualTriggers activar
create
desactivar
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Cambiaron los siguientes comportamientos de métodos:
Método Cambios advertisers.locationLists.create Ahora se admite la creación de recursos TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.patch Ahora se admite la actualización de los recursos TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.bulkEdit Ahora se admite la edición masiva de los recursos AssignedLocationen los recursosTARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.create Ahora se admite la creación de recursos AssignedLocationen recursosTARGETING_LOCATION_TYPE_PROXIMITYLocationList.Se agregaron los siguientes parámetros de consulta:
Método Parámetro(s) inventorySources.get Los siguientes campos se volvieron obligatorios:
Recurso Campos Anunciante Se agregaron los siguientes campos:
Recurso Campos BiddingStrategy InsertionOrder Socio TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Se quitaron los siguientes campos:
Recurso Campos InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Se agregaron los siguientes valores de enumeración:
Enum Valores CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Se quitaron los siguientes valores de enumeración:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
25 de agosto de 2023
Nuevas funciones
Se agregó compatibilidad con dos intercambios y dos nuevos tipos de estrategias de ofertas de YouTube y socios.
Se agregó un nuevo campo effectiveContentCategory a las líneas de pedido de YouTube y socios para mostrar el YoutubeAndPartnersContentCategory que usa la línea de pedido cuando se consideran los valores asignados a nivel del anunciante y de la línea de pedido.
v2
Se agregaron los siguientes campos:
Recurso Campos YoutubeAndPartnersSettings Se quitaron los siguientes campos:
Recurso Campos InventorySource subSitePropertyId
Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 de junio de 2023
Nuevas funciones
Se agregó un nuevo valor SdfVersion para la versión 6 de los archivos de datos estructurados (SDF) en las versiones 1 y 2.
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion SDF_VERSION_6
v1
Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion SDF_VERSION_6
9 de marzo de 2023
Nuevas funciones
Se agregó un nuevo valor LineItemWarningMessage que se asignará al campo warningMessages de un concepto si tiene el campo excludeFirstPartyAudience obsoleto establecido en true. El campo excludeFirstPartyAudience dejará de estar disponible y se establecerá en false después del 25 de marzo de 2023.
v2
Se agregaron los siguientes valores de enumeración:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Se agregaron los siguientes valores de enumeración:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 de febrero de 2023
Nuevas funciones
Se agregó la capacidad de recuperar recursos YouTubeAdGroup y YouTubeAdGroupAd, así como la segmentación de recursos de grupos de anuncios de YouTube. Además, también agregamos nuevos tipos de segmentación recuperables que se utilizan a nivel de los grupos de anuncios de YouTube. Para obtener más información, consulta nuestra nueva página de guía sobre cómo recuperar recursos de YouTube y socios.
Se agregó compatibilidad con cuatro intercambios adicionales en las versiones 1 y 2.
v2
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Se agregaron los siguientes campos:
Servicio Métodos AssignedTargetingOption YoutubeAndPartnersSettings Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Se agregaron los siguientes valores de enumeración:
Enum Valores Intercambio EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 de diciembre de 2022
Nuevas funciones
La versión 2 dejó de estar en versión beta pública y pasó a estar disponible para el público en general.
Se agregó un nuevo campo assignedTargetingOptionIdAlias al recurso AssignedTargetingOption, que se puede usar en lugar de assignedTargetingOptionId cuando se recupera y se borra la segmentación.
Este campo solo se establece para las opciones de segmentación asignadas de los tipos de segmentación que se asignan a través de una enumeración. El valor del alias es el valor de enumeración pertinente como una cadena.
Se agregó un nuevo campo billingConfig al recurso Advertiser.
Se agregó compatibilidad para recuperar líneas de pedido de YouTube y socios de transmisión libre, identificadas por tres valores nuevos de LineItemType.
Se aumentó el tamaño máximo de la página a 200 para varios métodos list en las versiones 1 y 2. El tamaño de página predeterminado no se modificó.
v2
Se agregaron los siguientes campos:
Recurso Campos Anunciante AssignedTargetingOption Se agregaron los siguientes valores de enumeración:
Enum Valores LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
v1
Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
Problemas conocidos
Esta actualización corrige los siguientes problemas conocidos en la versión 2:
- Las opciones de segmentación asignadas de los tipos de segmentación que se asignan con valores de enumeración en la versión 2 no se podían quitar ni recuperar con su
assignedTargetingOptionId, y, en cambio, se esperaba que los usuarios usaran el valor de enumeración. Con esta actualización, estas opciones de segmentación asignadas se pueden quitar o recuperar conassignedTargetingOptionIdo el valor de enumeración, identificado por el nuevo campoassignedTargetingOptionIdAliasen el recursoAssignedTargetingOption. - La solicitud de
bulkUpdatede la línea de pedido no usó correctamente el parámetro de solicitudadvertisersIdy devolvió un error. Con esta actualización, se corrigió el método y se cambió el nombre del parámetro de solicitud deadvertisersIdaadvertiserId.
27 de octubre de 2022
Se agregó la capacidad de duplicar un concepto existente dentro del InsertionOrder principal.
Se introdujo la compatibilidad parcial con la escritura de la segmentación de órdenes de inserción para un subconjunto de tipos de segmentación con la adición de los métodos create y delete al servicio advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.
Nuevas funciones
v2
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
No se agregaron funciones nuevas a la versión 1.
20 de Septiembre de 2022
Se lanzó la versión 2 en versión beta pública, que incluye los siguientes cambios:
- La capacidad de recuperar las líneas de pedido de YouTube & Partners y su configuración de segmentación con los métodos
getylisten los serviciosadvertisers.lineItemsyadvertisers.lineItems.targetingTypes.assignedTargetingOptions - Dos nuevos métodos de segmentación masiva en el servicio
advertisers.lineItemsque permiten editar y recuperar la segmentación asignada en varias líneas de pedido con una sola solicitud. - Se agregó un nuevo método
bulkUpdateque permite a los usuarios actualizar elentityStatusde varias líneas de pedido en una sola solicitud. - Nueva lógica de segmentación que requiere que los recursos
AssignedTargetingOptionde un subconjunto de tipos de segmentación se asignen y recuperen con valores de enumeración en lugar de IDs de opciones de segmentación recuperados con el serviciotargetingTypes.targetingOptions.
Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 1 a la versión 2.
Se agregó compatibilidad con tres nuevos intercambios en la versión 1.
Nuevas funciones
v2
A continuación, se incluye una lista de los cambios entre las versiones 1 y 2:
Se agregaron los siguientes métodos en la versión 2:
Servicio Métodos advertisers.lineItems bulkEditAssignedTargetingOptions
En la versión 2, se quitaron los siguientes métodos:
Servicio Métodos advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Se cambió el nombre de los siguientes métodos en la versión 2:
Servicio Nombre anterior del método Nombre del método nuevo advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Los recursos
AssignedTargetingOptionde los siguientes tipos de segmentación usan enumeraciones para la asignación de la segmentación en la versión 2. El campoassignedTargetingOptionIdpara los recursosAssignedTargetingOptionde estos tipos de segmentación también se actualizó en la versión 2 para usar versiones de cadena de los valores de enumeración:Tipo de orientación Tipo de enumeración TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Entorno TARGETING_TYPE_EXCHANGE Intercambio TARGETING_TYPE_GENDER Género TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilidad Se agregaron los siguientes campos en la versión 2:
Se quitaron los siguientes campos en la versión 2:
Los siguientes campos se volvieron obligatorios en la versión 2:
Se agregaron los siguientes valores de enumeración en la versión 2:
Enum Valores AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Intercambio EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
En la versión 2, se quitaron los siguientes valores de enumeración:
Enum Valores LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Se agregaron los siguientes valores de enumeración en la versión 1:
Enum Valores Intercambio EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 de mayo de 2022
Se agregó la capacidad de crear recursos InventorySource y administrar recursos GuaranteedOrder a través de nuevos métodos de escritura del servicio inventorySources y un nuevo servicio guaranteedOrders.
Se introdujo el campo modelReadiness en el recurso CustomBiddingAlgorithm. En este campo, se indica la preparación del modelo del algoritmo para cada anunciante que puede acceder a él.
Se habilitó la nueva funcionalidad del parámetro de consulta filter para el método advertisers.creatives.list, que permite al usuario recuperar solo las creatividades con un updateTime antes o después de una marca de tiempo determinada.
Se agregó compatibilidad con la versión más reciente del SDF, v5.5, a través de la incorporación de un valor de enumeración SdfVersion.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos guaranteedOrders inventorySources Se agregaron los siguientes campos:
Recurso Campos CustomBiddingAlgorithm InventorySource Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion Los siguientes métodos de lista ahora se pueden filtrar por las siguientes propiedades:
Método Campos advertisers.creatives.list
31 de marzo de 2022
Se agregó compatibilidad para recuperar y establecer la segmentación en la duración del contenido, el tipo de transmisión y el género.
Se agregó el campo billableOutcome al objeto InsertionOrder.
Se introdujo el campo raiseBidForDeals en el objeto MaximizeSpendBidStrategy, lo que permite a los usuarios establecer si la estrategia de ofertas aplica precios mínimos del anunciante para los acuerdos segmentados.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Se agregaron los siguientes valores de enumeración:
Enum Valores TargetingType
2 de febrero de 2022
Se agregó compatibilidad para crear, actualizar y editar miembros de ciertos recursos de FirstAndThirdPartyAudience de Segmentación por clientes. En la página Cómo subir públicos de Segmentación por clientes de nuestra nueva guía Usa públicos, se detalla cómo utilizar estas nuevas funciones.
Se introdujo un nuevo campo reservationType en los recursos InsertionOrder y LineItem que identifica si un recurso tiene garantía de etiqueta, garantía programática o no tiene garantía.
Se agregó la capacidad de recuperar y establecer si una línea de pedido segmenta automáticamente los intercambios nuevos a través de un nuevo campo excludeNewExchanges.
Además de las funciones nuevas, se duplicaron los límites de cuota predeterminados.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos firstAndThirdPartyAudiences Se agregaron los siguientes campos:
Recurso Campos FirstAndThirdPartyAudience InsertionOrder LineItem
8 de diciembre de 2021
Se agregó compatibilidad con la segmentación por tipo de contenido de audio en el tipo de segmentación TARGETING_TYPE_AUDIO_CONTENT_TYPE.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enumeración:
Enum Valores TargetingType
8 de noviembre de 2021
Se agregó compatibilidad total para administrar algoritmos de licitación personalizados y sus secuencias de comandos. Esto incluye lo siguiente:
- Funciones para crear
customBiddingAlgorithmsnuevos y actualizar los existentes - La capacidad de subir secuencias de comandos a través del proceso de recuperar una ubicación de recursos disponible y, luego, subir el archivo a esa ubicación
- Un nuevo servicio
customBiddingAlgorithms.scriptspara recuperar y crearcustomBiddingScripts
Se agregó una nueva página Implement Custom Bidding a nuestra guía Managing Line Items, en la que se describe el proceso para crear un algoritmo de ofertas personalizadas, subir una secuencia de comandos y asignar el algoritmo de ofertas personalizadas como estrategia de ofertas de una línea de pedido.
Se agregó compatibilidad con la versión más reciente del SDF, v5.4, a través de la incorporación de un valor de enumeración SdfVersion.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos customBiddingAlgorithms customBiddingAlgorithms.scripts media Se agregaron los siguientes valores de enumeración:
Enum Valores SdfVersion
14 de septiembre de 2021
Se agregó compatibilidad con la segmentación por proximidad en los tipos de segmentación TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI.
Se agregó la capacidad de buscar las opciones de segmentación disponibles TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI con targetingTypes.targetingOptions.search, ya que no se pueden recuperar con los métodos targetingTypes.targetingOptions.get o targetingTypes.targetingOptions.list.
Se agregaron los nuevos campos sharedAdvertiserIds y customBiddingAlgorithmState al recurso del algoritmo de ofertas personalizadas y se agregó compatibilidad con el tipo de algoritmo de ofertas personalizadas GOAL_BUILDER_BASED.
Se agregaron dos valores nuevos al enum Exchange.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Cuerpo de la solicitud de TargetingOptions.search Se agregaron los siguientes valores de enumeración:
Enum Valores CustomBiddingAlgorithmType Intercambio TargetingType Los siguientes métodos de lista ahora se pueden filtrar por las siguientes propiedades:
Método Campos customBiddingAlgorithms.list
4 de agosto de 2021
Se agregó compatibilidad con la segmentación del inventario habilitado para Open Measurement en el tipo de segmentación TARGETING_TYPE_OMID.
Se aumentó la cantidad máxima de opciones de segmentación asignadas que se pueden devolver en una sola página de varios métodos de lista de opciones de segmentación asignadas de anunciante, campaña, orden de inserción y línea de pedido con el parámetro del método pageSize.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enumeración:
Enum Valores TargetingType Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
26 de mayo de 2021
Se lanzó el servicio advertisers.invoices, que permite a los usuarios hacer lo siguiente:
- Recuperar las facturas emitidas a un anunciante durante un mes determinado
- Consultar el código de moneda que utilizó un anunciante durante un mes determinado
Se agregó el campo campaignBudgets al recurso de la campaña. Los segmentos de presupuesto de la orden de inserción se pueden vincular a un presupuesto de la campaña, lo que restringe el presupuesto total de los segmentos asociados al importe total del presupuesto de la campaña.
Se agregó compatibilidad con la segmentación por posición de contenido nativo en el nuevo tipo de segmentación TARGETING_TYPE_NATIVE_CONTENT_POSITION.
Se agregó un nuevo campo prismaEnabled al recurso advertiser, que permite a los usuarios habilitar la integración con la herramienta Prisma de Mediaocean.
Se habilitó la compatibilidad con el valor de enumeración ENTITY_STATUS_PAUSED para el campo entityStatus del anunciante.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.invoices Se agregaron los siguientes campos:
Recurso Campos Anunciante AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enumeración:
Enum Valores AssignedTargetingOption.Recency Exchange TargetingType Los siguientes valores de enumeración ahora son válidos para los siguientes campos:
Recurso Campo Valores Anunciante entityStatus ENTITY_STATUS_PAUSED
29 de abril de 2021
Se agregaron campos nuevos a los recursos Channel y Negative Keyword List que devuelven el recuento de los elementos de línea que usan el recurso para la segmentación. Se habilitaron nuevas propiedades de filter para el método de lista de líneas de pedido que permiten al usuario recuperar solo las líneas de pedido que utilizan canales específicos o listas de palabras clave negativas en su segmentación.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Canal Los siguientes métodos de lista ahora se pueden filtrar por las siguientes propiedades:
Método Campos advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 de marzo de 2021
Se agregó un nuevo método al servicio de artículos de línea que genera un artículo de línea con configuraciones predeterminadas. Estos valores predeterminados se basan en el tipo de línea de pedido determinado, así como en la configuración y la segmentación asignada de la orden de inserción principal.
Se habilitó la recuperación de la segmentación de la campaña a través de un nuevo servicio de segmentación de la campaña y un método de lista masiva adicional.
Se expandió la segmentación por aplicación para permitir la segmentación de aplicaciones en más plataformas.
Se realizaron varios cambios en los servicios advertisers.channels.sites, partners.channels.sites y advertisers.negativeKeywordLists.negativeKeywords para facilitar la administración del contenido de los canales y las listas de palabras clave negativas. Estos cambios incluyen lo siguiente:
- Se agregaron métodos
replace, que permiten que un usuario sobrescriba por completo el contenido existente de un canal o una lista de palabras clave negativas. - Se quitó el requisito de que no se incluyeran elementos existentes en los campos
createdSitesocreatedNegativeKeywordsde las solicitudes de edición masiva. - Aumento de la cantidad máxima de elementos que se pueden devolver en una sola página de una respuesta de sitios de lista o palabras clave negativas de lista.
Nuevas funciones
Se agregaron los siguientes métodos:
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption.AppAssignedTargetingOptionDetails Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
Método Tamaño máximo de página anterior Nuevo tamaño máximo de página advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Bajas
Los siguientes valores de enumeración ya no se pueden asignar a recursos nuevos o existentes:
Enum Valores PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 de febrero de 2021
Se introdujo un nuevo servicio de segmentación de órdenes de inserción y un método de lista masiva adicional que permite recuperar la segmentación asignada a las órdenes de inserción. Se expandió el recurso de creatividad y se agregaron campos de creatividad de solo salida para que los usen las creatividades de audio de terceros. Se agregaron nuevos tipos de objetivos de rendimiento para que los usen los recursos de orden de inserción y campaña.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Se agregaron los siguientes campos:
Recurso Campos Creatividad Se agregaron los siguientes valores de enumeración:
Enum Valores ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 de enero de 2021
Se habilitó la recuperación y administración de pedidos de inserción de TV y líneas de pedido de over-the-top con la introducción de un nuevo campo InsertionOrderType y un nuevo valor de enumeración LineItemType. Se agregó compatibilidad con las líneas de pedido de aplicaciones para dispositivos móviles a través de un campo de línea de pedido mobileApp.
Se expandió la compatibilidad con el intercambio, el público de Google y el SDF a través de valores de enumeración adicionales. Se introdujo la capacidad de filtrar y ordenar los valores de advertisers.list según la fecha y hora de la última actualización.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos InsertionOrder LineItem Se agregaron los siguientes valores de enumeración:
Enum Valores Exchange GoogleAudienceType LineItemType SdfVersion Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos anunciantes
4 de diciembre de 2020 .
Se agregó la capacidad de buscar opciones de segmentación por región geográfica y filtrar los resultados de varios métodos de lista de recursos por su hora de actualización más reciente. Se introdujo un nuevo LineItemWarningMessage para informar a los usuarios cuándo una línea de pedido usa la segmentación geográfica obsoleta.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos targetingTypes.targetingOptions Se agregaron los siguientes valores de enumeración:
Enum Valores Exchange LineItemWarningMessage Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 de noviembre de 2020
Se agregó la capacidad de crear, asignar y activar activadores manuales que inician la inversión de las líneas de pedido asociadas. Se introdujeron las opciones de expansión de la segmentación que, cuando se configuran, pueden expandir la segmentación de una línea de pedido para incluir a los usuarios similares a los de los públicos segmentados. Se agregaron campos de ID de segmento personalizado a los objetos de DoubleVerify y Integral Ad Science que se usan en la segmentación de la verificación de terceros.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos advertisers.manualTriggers Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Se agregaron los siguientes valores de enumeración:
Enum Valores LineItemFlightDateType Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list
12 de octubre de 2020
Se introdujeron mensajes de advertencia recuperables en el recurso de línea de pedido y un tipo de objetivo de rendimiento de la tasa de clics (CTR). Se agregó warningMessages como un campo filtrable cuando se enumeran líneas de pedido.
Además de las nuevas funciones, ya están vigentes los nuevos límites de cuota y hay disponible nueva documentación sobre cómo utilizar las solicitudes por lotes.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos LineItem Se agregaron los siguientes valores de enumeración:
Enum Valores PerformanceGoalType Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list
28 de agosto de 2020
Se agregaron campos nuevos a la respuesta del método de auditoría de anunciantes y campos nuevos que se pueden filtrar a varios métodos de lista.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Advertisers.Audit Response Body Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 de agosto de 2020
Se lanzaron nuevos servicios de administración de usuarios, socios y segmentación para socios. Se introdujeron herramientas para ayudar a los usuarios a evitar de forma proactiva alcanzar los límites de entidades de la cuenta. Se agregó compatibilidad con las líneas de pedido de audio y el uso de algoritmos de ofertas personalizados en las estrategias de ofertas de las líneas de pedido y los pedidos de inserción.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos customBiddingAlgorithms socios partners.targetingTypes.assignedTargetingOptions users Se agregaron los siguientes métodos:
Servicio Métodos anunciantes Se agregaron los siguientes campos:
Recurso Campos MaximizeSpendBidStrategy PerformanceGoalBidStrategy Se agregaron los siguientes valores de enumeración:
Enum Valores BiddingStrategyPerformanceGoalType LineItemType Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list Se agregaron los siguientes alcances para usar con los siguientes servicios:
Alcance Servicios https://www.googleapis.com/auth/display-video-user-management
24 de junio de 2020
Se lanzó una pequeña actualización que agrega un método de creación para los canales de socio y anunciante, nuevos campos de FirstAndThirdPartyAudience y valores de enumeración de exchange adicionales.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos advertisers.channels partners.channels Se agregaron los siguientes campos:
Recurso Campos FirstAndThirdPartyAudience Se agregaron los siguientes valores de enumeración:
Enum Valores Exchange Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.creatives.list
2 de junio de 2020
Se introdujo la capacidad de crear, aplicar parches y completar un subconjunto de entidades aptas para la segmentación, y se agregó la capacidad de modificar la segmentación a nivel del anunciante para tres tipos de segmentación: canal, exclusión de etiquetas de contenido digital y exclusión de categorías sensibles.
Nuevas funciones
Se agregaron los siguientes servicios:
Se agregaron los siguientes métodos:
Servicio Métodos anunciantes advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Se agregaron los siguientes campos:
Recurso Campos anunciante creatividad insertionOrder.insertionOrderBudgetSegment
27 de abril de 2020
Se lanzó un amplio conjunto de funciones que expande el alcance de la API más allá del formato SDF. Se agregó la administración de recursos principales que te permite crear, recuperar, actualizar y borrar entidades, como anunciantes, campañas, órdenes de inserción, líneas de pedido y creatividades. Las nuevas capacidades también permiten editar la segmentación a nivel de la línea de pedido.
Nuevas funciones
Se agregaron los siguientes servicios:
9 de marzo de 2020
Se lanzó la versión 1 de la API de Display & Video 360. Esta es la versión inicial de la API.
Problemas conocidos
Ninguno