En esta página, se incluyen notas de la versión de Display & API de Video 360.
Versión más reciente de la API: v3
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
Se agregó compatibilidad para descargar archivos de datos estructurados de líneas de pedido y grupos de anuncios en Formato de QA en la versión 3.
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 pedido de inserción
recurso. 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 una nueva
Servicio floodlightGroups.floodlightActivities.
Se agregó un nuevo campo que comunica si un canal de YouTube y Línea de pedido de Partners incluye el inventario de Google TV en su segmentación.
Se agregó un nuevo campo para retransmitir la última hora de acceso de una Pantalla y Video 360 usuario.
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 al subir la Segmentación por clientes. miembros del público 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 enum AdGroupFormat en la versión 3 para que sea más preciso.
reflejan el formato relevante.
Se agregó compatibilidad con archivos de datos estructurados v7 con la incorporación de la
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 por proximidad, lo que permite el uso del
Servicio
advertisers.locationLists.assignedLocationspara crear y borrar las ubicaciones asignadas aTARGETING_LOCATION_TYPE_PROXIMITYLocationListrecursos. - Un nuevo campo booleano
enableOptimizedTargeting, que reemplaza el campotargetingExpansionLevelen el objetoTargetingExpansionConfig. - El requisito del campo
billingConfigen el recursoAdvertiser, que debe incluirse cuando se haga solicitudesadvertisers.createy una nueva CampobillingConfigenPartnerrecurso. - Nuevos recursos
AdGroupyAdGroupAdque reemplazar los recursosYoutubeAdGroupyYoutubeAdGroupAden la v2.
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 LineItemType nuevos, uno nuevo
YoutubeAndPartnersBiddingStrategyType y un elemento nuevo
PartnerCostType 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
El siguiente comportamiento del método cambió:
Método Cambios advertisers.locationLists.create Ahora admite la creación de recursos LocationListdeTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.patch Ahora admite la actualización de recursos LocationListdeTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.assignedLocations.bulkEdit Ahora admite la edición masiva de los recursos AssignedLocationenTARGETING_LOCATION_TYPE_PROXIMITYLocationListrecursos.advertisers.locationLists.assignedLocations.create Ahora admite la creación de recursos AssignedLocationenTARGETING_LOCATION_TYPE_PROXIMITYrecursosLocationList.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 nuevos YouTube & Socios tipos de estrategias de ofertas.
Se agregó un nuevo campo effectiveContentCategory a YouTube y
de Google Partners para mostrar
La línea de pedido usa YoutubeAndPartnersContentCategory cuando
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
al campo warningMessages de una línea de pedido si
el campo obsoleto excludeFirstPartyAudience se estableció en
true Se desactivará el campo excludeFirstPartyAudience
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 YouTubeAdGroup y
YouTubeAdGroupAd y también un grupo de anuncios de YouTube
la segmentación de recursos. Además, agregamos nuevas funciones
tipos de segmentación recuperables que se usan en los grupos de anuncios de YouTube
o a nivel de organización. Lee nuestra nueva página de guía sobre cómo recuperar YouTube y Socios
para obtener más información.
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 archivo
recurso AssignedTargetingOption, que se puede usar en lugar del
assignedTargetingOptionId cuando se recupere y borre 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 archivo
Advertiser recurso.
Se agregó compatibilidad para recuperar contenido de YouTube y Las líneas de pedido de transmisión libre de socios
Se identifica con tres valores LineItemType nuevos.
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
el tamaño de página predeterminado no cambia.
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 de la versión 2:
- Opciones de segmentación asignadas de los tipos de segmentación que se asignan mediante enum
no se pudieron quitar ni recuperar los valores de la v2
usando su
assignedTargetingOptionIdy, en cambio, esperaba usar el valor enum. Con esta actualización, estas opciones de segmentación opciones que se pueden eliminar o recuperar con elassignedTargetingOptionIdo el valor enum, identificado por el nuevo campoassignedTargetingOptionIdAliasen laAssignedTargetingOption. - No se utilizó correctamente la solicitud de línea de pedido
bulkUpdateel parámetro de solicitudadvertisersId, lo que muestra un error Con esta actualización, se corrigió el método y se cambió el nombre del parámetro de la solicitudadvertisersIdparaadvertiserId.
27 de octubre de 2022
Se agregó la capacidad de duplicar una línea de pedido existente dentro del elemento superior.
InsertionOrder
Se introdujo la compatibilidad con la escritura de segmentación de pedido de inserción parcial para un subconjunto de
tipos de segmentación con la adición de create y
delete a la
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
servicio.
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 datos de YouTube y Líneas de pedido de socios y su segmentación
Configuración con los métodos
getylisten laadvertisers.lineItemsyadvertisers.lineItems.targetingTypes.assignedTargetingOptionsservicios. - Dos métodos nuevos de segmentación masiva en el servicio
advertisers.lineItemsque permiten editar y recuperar Se asignó la segmentación en varias líneas de pedido con una en una sola solicitud. - Un nuevo método
bulkUpdateque permite a los usuarios actualizar laentityStatusde varias líneas de pedido en una sola solicitud. - Nueva lógica de segmentación que requiere
AssignedTargetingOptionrecursos de un subconjunto de tipos de segmentación Se asignan y recuperan con valores de enumeración en lugar de IDs de opciones de segmentación. recuperadas 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 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 socios bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Los recursos
AssignedTargetingOptionde los siguientes tipos de segmentación usan enumeraciones para la asignación de segmentación en la v2. 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 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 de InventorySource y
administrar GuaranteedOrder recursos a través de nuevas
con los métodos de escritura del servicio inventorySources y una nueva
servicio de guaranteedOrders.
Se introdujo el campo modelReadiness en el
CustomBiddingAlgorithm recurso. Este campo enumera la preparación de la
modelo de 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
para recuperar solo las creatividades con un updateTime
antes o después de una marca de tiempo determinada.
Se agregó compatibilidad con la versión de SDF más reciente, v5.5, mediante la versión
se agrega un valor enum 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 en duración del contenido, tipo de transmisión y género.
Se agregó el campo billableOutcome a InsertionOrder
.
Se introdujo el campo raiseBidForDeals en el
MaximizeSpendBidStrategy, lo que permite a los usuarios establecer si la oferta
en el que se aplican los precios mínimos de los anunciantes 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 los miembros de ciertas Segmentación por clientes
FirstAndThirdPartyAudience. El
Sube los públicos de Segmentación por clientes en nuestra nueva plataforma.
En la guía Uso de públicos, se detalla cómo utilizar estas nuevas funciones.
Se agregó un nuevo campo reservationType en
InsertionOrder y LineItem
Recursos que identifican si un recurso es de Etiquetas garantizadas, Programática
Garantizadas o no garantizadas.
Se agregó la capacidad de recuperar y establecer si una línea de pedido se segmenta automáticamente.
intercambios nuevos mediante un nuevo 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 elementos nuevos y actualizar los existentes
customBiddingAlgorithms - La capacidad de subir secuencias de comandos a través del proceso de recuperar una ubicación de recurso disponible y, luego, subiendo el archivo a esa ubicación.
- Un nuevo servicio de
customBiddingAlgorithms.scriptspara recuperar y crearcustomBiddingScripts.
Se agregó una nueva página para implementar ofertas personalizadas al nuestra guía Cómo administrar líneas de pedido, en la que se describe crear un algoritmo de ofertas personalizadas, subir una secuencia de comandos asignar el algoritmo de ofertas personalizadas como la estrategia de ofertas de una línea de pedido.
Se agregó compatibilidad con la versión de SDF más reciente, v5.4, mediante la
se agrega un valor enum 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 orientación por proximidad en los tipos de orientación.
TARGETING_TYPE_BUSINESS_CHAIN y
TARGETING_TYPE_POI
Se agregó la capacidad de buscar
TARGETING_TYPE_BUSINESS_CHAIN y
TARGETING_TYPE_POI opciones de segmentación con
targetingTypes.targetingOptions.search, ya que no pueden
recuperados a través de targetingTypes.targetingOptions.get
targetingTypes.targetingOptions.list métodos.
Se agregaron nuevas sharedAdvertiserIds y
customBiddingAlgorithmState para las ofertas personalizadas
recurso del algoritmo y más compatibilidad con el
GOAL_BUILDER_BASED es el tipo de algoritmo de las ofertas personalizadas.
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 Open Measurement habilitado.
segmentación por inventario en el tipo de segmentación.
TARGETING_TYPE_OMID
Aumento de la cantidad máxima de opciones de segmentación asignadas que se pueden devolver
en una sola página de varios anunciantes, campañas,
Segmentación asignada por pedido de inserción y línea de pedido
de la lista de opciones 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
Lanzaste el servicio advertisers.invoices, que permite
usuarios:
- 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 a la campaña
recurso. Los segmentos de presupuesto de pedido de inserción pueden vincularse
Un presupuesto de la campaña, lo que restringe el presupuesto total del
segmentos asociados al importe total del presupuesto de la campaña.
Se agregó compatibilidad con
segmentación de posición de contenido nativo en la nueva
el tipo de segmentación TARGETING_TYPE_NATIVE_CONTENT_POSITION.
Se introdujo un nuevo campo prismaEnabled para el anunciante
lo que permite a los usuarios habilitar la integración con la herramienta Prisma de Mediaocean.
Se habilitó la compatibilidad con el valor enum ENTITY_STATUS_PAUSED para
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 al Canal y
Recursos de la lista de palabras clave negativas que devuelven el recuento de líneas
usando el recurso para la segmentación. Se habilitó el nuevo filter
propiedades del 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 palabras clave negativas
listas 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 la línea de pedido que genera un con configuraciones predeterminadas. Estos valores predeterminados se basan en el un tipo de línea de pedido determinado, así como la configuración y la segmentación del pedido de inserción superior.
Se habilitó la recuperación de la segmentación de campaña mediante una un nuevo servicio de segmentación de campañas método de lista masiva adicional.
Se amplió la segmentación de aplicaciones para permitir la segmentación de aplicaciones. en más plataformas.
Se realizaron varios cambios en advertisers.channels.sites,
partners.channels.sites y
Servicios de advertisers.negativeKeywordLists.negativeKeywords a
permiten una administración más sencilla del contenido del canal y de la lista de palabras clave negativas. Estos
Entre los cambios, se incluyen los siguientes:
- La adición de métodos
replace, que permite al usuario reemplazar por completo el el contenido existente de un canal o una lista de palabras clave negativas. - La eliminación del requisito de que ninguna parte
elementos incluidos en la
createdSitesocreatedNegativeKeywordscampos de edición masiva solicitudes. - El aumento de la cantidad máxima de elementos que se pueden devolver en un solo de una lista de sitios o enumera palabras clave negativas.
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
Incorporamos un nuevo servicio de segmentación para pedidos de inserción y método de lista masiva adicional que permite recuperar la segmentación asignada a los pedidos de inserción. Se expandió el recurso creativo, agregando campos de creatividades de solo salida para que los use creatividades de audio de terceros. Se agregaron nuevos tipos de objetivos de rendimiento. para que se use en pedido de inserción y campaña de Google Cloud.
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 transmisión libre
elementos mediante la introducción de una
nuevo campo InsertOrderType y un
nuevo valor enum LineItemType. Se agregó compatibilidad con apps para dispositivos móviles
a través de un campo de línea de pedido mobileApp.
Intercambio, público de Google y
Compatibilidad con SDF a través de valores de enumeración adicionales Se introdujo el
capacidad para filtrar y ordenar advertisers.list
valores según la hora de la actualización más reciente.
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 función para buscar Opciones de segmentación por región geográfica y filtrar varios recursos mostrar los resultados del método según la hora de la última actualización Se introdujo un elemento new LineItemWarningMessage para informar a los usuarios cuándo se produce un la línea de pedido usa la segmentación geográfica que dejó de estar disponible.
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 de crear, asignar y activar. activadores manuales que inician líneas de pedido asociadas de gastos operativos. Se introdujeron opciones de expansión de la segmentación que, cuando se establece, puede expandir la segmentación de una línea de pedido para incluir usuarios similares los de los públicos objetivo. Anexó campos de ID de segmentos personalizados a Integral Ad Science y DoubleVerify objetos utilizados en 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 en la línea de pedido
y un tipo de objetivo de rendimiento de tasa de clics (CTR). Agregado
warningMessages como campo filtrable cuando se muestran líneas de pedido
Además de las nuevas funciones, se implementaron nuevos límites de cuota y hay disponible documentación nueva 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 del anunciante y nuevos campos filtrables a varios métodos de lista.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Cuerpo de la respuesta de Campaigns.Audit 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. Agregado que 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
Lanzamiento de campañas de Display & Versión 1 de la API de Video 360. Esta es la versión inicial de la API.
Problemas conocidos
Ninguno