En esta página, se proporcionan notas de la versión de la API de Display & Video 360.
Versión más reciente de la API: v3
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 Los siguientes métodos ahora 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
Los siguientes métodos ahora 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 apps.
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 orientar a intercambios nuevos.
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 nuevo campo para informar si una línea de pedido de YouTube & Partners incluye el 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 User YoutubeAndPartnersInventorySourceConfig
v2
Se agregaron los siguientes métodos:
Servicio Métodos floodlightGroups.floodlightActivities Se agregaron los siguientes campos:
Recurso Campos User 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 Segmentación por clientes en todas las versiones publicadas.
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
Se movió v3 de la versión beta pública a la disponibilidad general.
Se cambió el nombre de un valor de enum AdGroupFormat
en la versión 3 para reflejar con mayor precisión el formato relevante.
Se agregó compatibilidad con archivos de datos estructurados v7 y se agregó el 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:
- La capacidad de administrar completamente las listas de ubicaciones de proximidad, lo que permite usar el servicio de
advertisers.locationLists.assignedLocations
para crear y borrar ubicaciones asignadas a los recursos deTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Un nuevo campo booleano
enableOptimizedTargeting
, que reemplaza el campotargetingExpansionLevel
en el objetoTargetingExpansionConfig
. - El requisito del campo
billingConfig
en el recursoAdvertiser
, que debe incluirse cuando se realizan solicitudesadvertisers.create
, y un nuevo campobillingConfig
en el recursoPartner
. - Se agregaron recursos
AdGroup
yAdGroupAd
nuevos que reemplazan los recursosYoutubeAdGroup
yYoutubeAdGroupAd
en v2.
Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 2 a la 3.
Se agregó compatibilidad con 3 valores LineItemType
nuevos, 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
crear
desactivar
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
El siguiente comportamiento del método cambió:
Método Cambios advertisers.locationLists.create Ahora admite la creación de recursos LocationList
deTARGETING_LOCATION_TYPE_PROXIMITY
.advertisers.locationLists.patch Ahora admite la actualización de recursos LocationList
deTARGETING_LOCATION_TYPE_PROXIMITY
.advertisers.locationLists.assignedLocations.bulkEdit Ahora admite la edición masiva de los recursos AssignedLocation
enTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
recursos.advertisers.locationLists.assignedLocations.create Ahora admite la creación de recursos AssignedLocation
enTARGETING_LOCATION_TYPE_PROXIMITY
recursosLocationList
.Se agregaron los siguientes parámetros de consulta:
Método Parámetros inventorySources.get Se han completado los siguientes campos:
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 tipos de estrategias de oferta de YouTube & Partners nuevos.
Se agregó un nuevo campo effectiveContentCategory
a las líneas de pedido de YouTube & Partners para mostrar el YoutubeAndPartnersContentCategory
que usa la línea de pedido cuando se consideran los valores asignados tanto a nivel del anunciante como 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 los archivos de datos estructurados (SDF) v6 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 una línea de pedido si tiene el campo obsoleto excludeFirstPartyAudience
configurado como true
. El campo excludeFirstPartyAudience
se desactivará 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 segmentación de recursos de grupos de anuncios de YouTube. Además, también agregamos nuevos tipos de segmentación recuperables que se usan a nivel de los grupos de anuncios de YouTube. Para obtener más información, lee nuestra nueva página de guía sobre cómo recuperar los 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
Se movió v2 de la versión beta pública a la disponibilidad general.
Se agregó un nuevo campo assignedTargetingOptionIdAlias
al recurso AssignedTargetingOption
, que se puede usar en lugar de assignedTargetingOptionId
cuando se recupera y 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 enumeración. El valor del alias es el valor de enumeración relevante como una cadena.
Se agregó un nuevo campo billingConfig
al recurso Advertiser
.
Se agregó compatibilidad para recuperar líneas de pedido de transmisión libre de YouTube y socios, 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 la versión 1 y la 2. El tamaño de página predeterminado no se modifica.
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:
Errores conocidos
Esta actualización corrige los siguientes problemas conocidos de la versión 2:
- No se pudieron quitar ni recuperar las opciones de segmentación asignadas de los tipos de segmentación que se asignaron mediante valores de enumeración en la versión 2 con su
assignedTargetingOptionId
y, en su lugar, se esperaba que los usuarios usaran el valor enum. Con esta actualización, estas opciones de segmentación asignadas se pueden quitar o recuperar conassignedTargetingOptionId
o el valor de enumeración, identificado por el nuevo campoassignedTargetingOptionIdAlias
en el recursoAssignedTargetingOption
. - La solicitud
bulkUpdate
de la línea de pedido no usaba de forma correcta el parámetro de solicitudadvertisersId
, por lo que se mostró un error. Con esta actualización, se corrigió el método y se cambió el nombre del parámetro de solicitud deadvertisersId
aadvertiserId
.
27 de octubre de 2022
Se agregó la capacidad de duplicar una línea de pedido existente dentro del elemento superior InsertionOrder
.
Se agregó la compatibilidad de escritura para la segmentación de pedidos de inserción parcial 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 mediante los métodos
get
ylist
en los serviciosadvertisers.lineItems
yadvertisers.lineItems.targetingTypes.assignedTargetingOptions
- Hay dos métodos nuevos de segmentación masiva en el servicio
advertisers.lineItems
que permiten editar y recuperar la segmentación asignada en varias líneas de pedido con una sola solicitud. - Un nuevo método
bulkUpdate
que permite a los usuarios actualizar elentityStatus
de varias líneas de pedido en una sola solicitud - Nueva lógica de segmentación que requiere que los recursos
AssignedTargetingOption
de un subconjunto de tipos de segmentación se asignen y recuperen usando 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 2.
Se agregó compatibilidad con tres intercambios nuevos en la versión 1.
Nuevas funciones
v2
A continuación, se incluye una lista de los cambios entre la v1 y la v2:
Se agregaron los siguientes métodos a la versión 2:
Servicio Métodos advertisers.lineItems bulkEditAssignedTargetingOptions
En la v2, se quitaron los siguientes métodos:
Servicio Métodos advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Se cambiaron los nombres de los siguientes métodos en la v2:
Servicio Nombre anterior del método Nombre del nuevo método advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Los recursos
AssignedTargetingOption
de los siguientes tipos de segmentación usan enumeraciones para la asignación de segmentación en la v2. El campoassignedTargetingOptionId
para los recursosAssignedTargetingOption
de 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 a la versión 2:
En la versión 2, se quitaron los siguientes campos:
Los siguientes campos son obligatorios en la v2:
Se agregaron los siguientes valores de enumeración a la v2:
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
Se quitaron los siguientes valores de enumeración en la v2:
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 a 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 de guaranteedOrders
.
Se introdujo el campo modelReadiness
en el recurso CustomBiddingAlgorithm
. En este campo, se enumera 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 solo recuperar creatividades con un updateTime
antes o después de una marca de tiempo determinada.
Se agregó compatibilidad con la versión más reciente de SDF, v5.5, mediante 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 configurar la segmentación por duración del contenido, tipo de transmisión y 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 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 los miembros de determinados recursos de FirstAndThirdPartyAudience
de Segmentación por clientes. En la página Sube públicos de Segmentación por clientes de nuestra nueva guía Cómo usar los públicos, se explica cómo usar estas funciones nuevas.
Se agregó un nuevo campo reservationType
en los recursos InsertionOrder
y LineItem
que identifica si un recurso tiene etiqueta garantizada, Programática garantizada o no garantizada.
Se agregó la capacidad de recuperar y establecer si una línea de pedido se orienta automáticamente a 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 ofertas personalizadas y sus secuencias de comandos. Esto incluye lo siguiente:
- Funciones para crear un
customBiddingAlgorithms
nuevo y actualizar uno existente. - La capacidad de subir secuencias de comandos mediante el proceso de recuperación de una ubicación de recursos disponible y, luego, subir el archivo a esa ubicación
- Un servicio
customBiddingAlgorithms.scripts
nuevo para recuperar y crearcustomBiddingScripts
.
Se agregó una nueva página Implementa ofertas personalizadas a nuestra guía Cómo administrar líneas de pedido, que describe el proceso de crear un algoritmo de ofertas personalizadas, subir una secuencia de comandos y asignar el algoritmo de ofertas personalizadas como la estrategia de ofertas de una línea de pedido.
Se agregó compatibilidad con la versión más reciente de SDF, v5.4, mediante 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 TARGETING_TYPE_BUSINESS_CHAIN
y TARGETING_TYPE_POI
disponibles con targetingTypes.targetingOptions.search
, ya que no se pueden recuperar a través de los métodos targetingTypes.targetingOptions.get
o targetingTypes.targetingOptions.list
.
Se agregaron nuevos campos sharedAdvertiserIds
y customBiddingAlgorithmState
para el recurso Algoritmo de ofertas personalizadas, y se agregó compatibilidad con el tipo de algoritmo de ofertas personalizadas GOAL_BUILDER_BASED
.
Se agregaron dos valores nuevos a la enum Exchange
.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Cuerpo de la solicitud deTargetingOptions.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 de inventario habilitada 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 mostrar en una sola página con varios métodos de lista de opciones de segmentación asignados por anunciantes, campañas, pedidos de inserción y líneas de pedido mediante 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
Lanzaste el servicio advertisers.invoices
, que les permite a los usuarios hacer lo siguiente:
- recuperar las facturas emitidas a un anunciante durante un mes determinado
- buscar el código de moneda que utiliza un anunciante durante un mes determinado
Se agregó el campo campaignBudgets
al recurso de campaña. Los segmentos de presupuesto de pedido de inserción se pueden vincular a un presupuesto de 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 del anunciante, lo que permite a los usuarios habilitar la integración con la herramienta Prisma de Mediaocean.
Se habilitó la compatibilidad con el valor de enum 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 Intercambio 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 Canal y Lista de palabras clave negativas que muestran el recuento de líneas de pedido con el recurso para la segmentación. Se habilitaron propiedades filter
nuevas para el método de lista de líneas de pedido que permiten al usuario solo recuperar líneas de pedido que usan 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 método nuevo al servicio de línea de pedido que genera una línea de pedido 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 del pedido de inserción superior.
Se habilitó la recuperación de la segmentación de campañas mediante un nuevo servicio de segmentación de campaña y un método adicional de lista masiva.
Se amplió la segmentación de apps para permitir la segmentación de apps en más plataformas.
Se realizaron varios cambios en los servicios de advertisers.channels.sites
, partners.channels.sites
y advertisers.negativeKeywordLists.negativeKeywords
para facilitar la administración del contenido del canal y de la lista de palabras clave negativas. Entre estos cambios, se incluyen los siguientes:
- La adición de métodos
replace
, que permite a un usuario reemplazar por completo el contenido existente de un canal o de una lista de palabras clave negativas - La eliminación del requisito de que no se incluyan elementos existentes en los campos
createdSites
ocreatedNegativeKeywords
de las solicitudes de edición masiva. - El aumento de la cantidad máxima de elementos que se pueden mostrar en una sola página de una respuesta de lista de sitios o de 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 1,000 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 agregaron un nuevo servicio de segmentación para pedidos de inserción y un método adicional de lista masiva que permiten recuperar la segmentación asignada a los pedidos de inserción. Se amplió el recurso de creatividades mediante la incorporación de campos de creatividades 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 pedido de inserción y de 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 libres mediante la introducción de un nuevo campo InsertOrderType y un nuevo valor de enumeración LineItemType. Se agregó compatibilidad con líneas de pedido de apps para dispositivos móviles a través de un campo de línea de pedido mobileApp
.
Se amplió la compatibilidad con intercambio, público de Google y SDF a través de valores de enumeración adicionales. Se introdujo la capacidad de filtrar y ordenar los valores de advertisers.list
por la 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 Intercambio GoogleAudienceType LineItemType SdfVersion Los siguientes métodos de lista ahora se pueden ordenar y filtrar según los siguientes campos:
Método Campos anunciantes
4 de diciembre de 2020 .
Se agregó la capacidad para buscar opciones de segmentación de región geográfica y filtrar los resultados de varios métodos de listas de recursos por su última hora de actualización. Se agregó un nuevo LineItemWarningMessage para informar a los usuarios cuando una línea de pedido usa una 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 Intercambio LineItemWarningMessage Los siguientes métodos de lista ahora se pueden ordenar y filtrar según los siguientes campos:
Método Campos advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 de noviembre de 2020
Se agregó la capacidad para crear, asignar y activar activadores manuales que inician el gasto de las líneas de pedido asociadas. Se introdujeron 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 usuarios similares a los de los públicos objetivo. Anexó campos de ID de segmento personalizado a los objetos DoubleVerify y de Integral Ad Science que se usaron en la segmentación por 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 agregaron mensajes de advertencia recuperables al recurso de línea de pedido y un tipo de objetivo de rendimiento de tasa de clics (CTR). Se agregó warningMessages
como un campo filtrable cuando se muestran líneas de pedido.
Además de las funciones nuevas, ahora entraron en vigencia nuevos límites de cuota y hay documentación nueva sobre cómo usar 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 del anunciante y nuevos campos filtrables a varios métodos de lista.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Anunciantes.Cuerpo de la respuesta de auditoría 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
Lanzamos nuevos servicios de administración de usuarios, socios y orientación para socios. Se agregaron herramientas para ayudar a los usuarios a evitar de manera proactiva alcanzar los límites de entidades de la cuenta. Se agregó compatibilidad para líneas de pedido de audio y el uso de algoritmos de ofertas personalizadas en las estrategias de ofertas de líneas de pedido y orden de inserción.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos customBiddingAlgorithms socios partners.targetingTypes.assignedTargetingOptions usuarios 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 según los siguientes campos:
Método Campos advertisers.lineItems.list Se agregaron los siguientes permisos para usarlos en 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 en la que se agregó un método de creación para los canales de socio y anunciante, nuevos campos FirstAndThirdPartyAudience y valores de enumeración 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 Intercambio 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 propagar un subconjunto de entidades a las que se puede orientar, 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 gran conjunto de funciones, lo que amplió el alcance de la API más allá de SDF. Se agregó la administración de recursos principales que te permite crear, recuperar, actualizar y borrar entidades, como anunciantes, campañas, pedidos de inserción, líneas de pedido y creatividades. Las nuevas funciones 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.
Errores conocidos
Ningún contenido de este tipo