En esta página, se incluyen notas de la versión de la API de Display & Video 360.
Versión más reciente de la API: v3
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 enum:
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 enum:
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 miembros de los públicos de Segmentación por clientes de forma explícita.
Se agregó compatibilidad para orientar a nuevos intercambios.
v3
Se agregaron los siguientes campos:
Recurso Campos firstAndThirdPartyAudiences.editCustomerMatchMembers Se agregaron los siguientes valores enum:
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 enum:
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 servicio floodlightGroups.floodlightActivities
nuevo.
Se agregó un nuevo campo que informa si una línea de pedido YouTube & Partners incluye un 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 aprobar 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
La versión 3 se trasladó de la versión beta pública a la de disponibilidad 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 relevante.
Se agregó compatibilidad para los archivos de datos estructurados v7 con la adición del valor de enumeración SDF_VERSION_7
en las versiones 2 y 3.
v3
Se quitaron los siguientes valores enum:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_ACTION
Se agregaron los siguientes valores enum:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Se agregaron los siguientes valores enum:
Enum Valores SdfVersion SDF_VERSION_7
2 de octubre de 2023
Nuevas funciones
Se lanzó la versión 3 de la versión beta pública, que incluye los siguientes cambios:
- La capacidad de administrar por completo las listas de ubicaciones de proximidad, lo que permite el uso del servicio
advertisers.locationLists.assignedLocations
para crear y borrar ubicaciones asignadas a recursosTARGETING_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
. - Recursos
AdGroup
yAdGroupAd
nuevos que reemplazan los recursosYoutubeAdGroup
yYoutubeAdGroupAd
en 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 3.
Se agregó compatibilidad con 3 valores LineItemType
nuevos, un YoutubeAndPartnersBiddingStrategyType
nuevo y un PartnerCostType
nuevos 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
Cambió el siguiente comportamiento del método:
Método Cambios advertisers.locationLists.create Ahora admite la creación de recursos TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.patch Ahora admite la actualización de recursos TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.bulkEdit Ahora admite la edición masiva de los recursos AssignedLocation
en los recursosTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.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 Los siguientes campos son 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 enum:
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 enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Se agregaron los siguientes valores enum:
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 oferta 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 enum:
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 enum:
Enum Valores SdfVersion SDF_VERSION_6
v1
Se agregaron los siguientes valores enum:
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 enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Se agregaron los siguientes valores enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 de febrero de 2023
Nuevas funciones
Se agregó la capacidad de recuperar los recursos YouTubeAdGroup
y YouTubeAdGroupAd
, así como la segmentación de recursos de grupos de anuncios de YouTube. Además, 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, consulta nuestra nueva página de guía sobre cómo recuperar los recursos de YouTube y Partners.
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 enum:
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 enum:
Enum Valores Intercambio EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 de diciembre de 2022
Nuevas funciones
La versión 2 se trasladó de la versión beta pública a la de disponibilidad general.
Se agregó un nuevo campo assignedTargetingOptionIdAlias
al recurso AssignedTargetingOption
, que se puede usar en lugar del assignedTargetingOptionId
cuando se recupera y borra la segmentación.
Este campo solo se establece para las opciones de segmentación asignadas de tipos de segmentación
asignados mediante enum. El valor del alias es el valor enum relevante como una cadena.
Se agregó un nuevo campo billingConfig
al recurso Advertiser
.
Se agregó compatibilidad para recuperar elementos de una sola línea de YouTube y socios, identificados por tres valores LineItemType
nuevos.
Se aumentó el tamaño máximo de la página a 200 para varios métodos de list
en las versiones 1 y 2. El tamaño predeterminado de la página no se modifica.
v2
Se agregaron los siguientes campos:
Recurso Campos Anunciante AssignedTargetingOption Se agregaron los siguientes valores enum:
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 la página para los siguientes métodos de lista:
v1
Se aumentó el tamaño máximo de la página para los siguientes métodos de lista:
Errores conocidos
Esta actualización corrige los siguientes problemas conocidos en la versión 2:
- Las opciones de segmentación asignadas a los tipos de segmentación asignados con valores
enum en la versión 2 no se pudieron quitar ni recuperar
con su
assignedTargetingOptionId
. En cambio, se esperaba que los usuarios usaran el valor enum. Con esta actualización, estas opciones de segmentación asignadas se pueden quitar o recuperar con elassignedTargetingOptionId
o el valor de enumeración, que se identifica mediante el nuevo campoassignedTargetingOptionIdAlias
en el recursoAssignedTargetingOption
. - La solicitud
bulkUpdate
de la línea de pedido no usaba correctamente el parámetro de solicitudadvertisersId
, lo que mostraba 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 de la InsertionOrder
superior.
Se introdujo la compatibilidad de escritura de 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 líneas de pedido de YouTube & Partners y su configuración de segmentación con los métodos
get
ylist
en los serviciosadvertisers.lineItems
yadvertisers.lineItems.targetingTypes.assignedTargetingOptions
- Hay dos nuevos métodos 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 se asignen y recuperen los recursos
AssignedTargetingOption
de un subconjunto de tipos de segmentación con valores de enumeración en lugar de los 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 intercambios nuevos en la versión 1.
Nuevas funciones
v2
La siguiente es una lista de los cambios entre las versiones 1 y 2:
En la versión 2, se agregaron los siguientes métodos:
Servicio Métodos advertisers.lineItems bulkEditAssignedTargetingOptions
En la versión 2, se quitaron los siguientes métodos:
Servicio Métodos advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
En la versión 2, se cambió el nombre de los siguientes métodos:
Servicio Nombre del método anterior Nombre del método nuevo 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 la segmentación en la versión 2. El campoassignedTargetingOptionId
para los recursosAssignedTargetingOption
de estos tipos de segmentación también se actualizó en la versión 2 para usar versiones de cadenas de los valores enum:Tipo de orientación Tipo enum 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 En la versión 2, se agregaron los siguientes campos:
En la versión 2, se quitaron los siguientes campos:
Los siguientes campos son obligatorios en la versión 2:
En la versión 2, se agregaron los siguientes valores de enumeración:
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 enum:
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 de servicio inventorySources
y un nuevo servicio de guaranteedOrders
.
Se introdujo el campo modelReadiness
en el recurso CustomBiddingAlgorithm
. Este campo muestra la preparación del modelo del algoritmo para cada anunciante que puede acceder a él.
Se habilitó la funcionalidad nueva 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 de SDF más reciente, v5.5, por medio 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 enum:
Enum Valores SdfVersion Los siguientes métodos de lista ahora se pueden filtrar con las siguientes propiedades:
Método Campos advertisers.creatives.list
31 de marzo de 2022
Se agregó compatibilidad para recuperar y configurar la segmentación según la duración del contenido, el tipo de transmisión y el género.
Se agregó el campo billableOutcome
al objeto InsertionOrder
.
Se agregó el campo raiseBidForDeals
al objeto MaximizeSpendBidStrategy
, lo que permite a los usuarios configurar 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 enum:
Enum Valores TargetingType
2 de febrero de 2022
Se agregó compatibilidad para crear, actualizar y editar a los 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 en nuestra nueva guía Cómo usar los públicos, se explica cómo utilizar 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 para recuperar y establecer si una línea de pedido se orienta automáticamente a intercambios nuevos mediante 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 enum:
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:
- Funciones para crear elementos nuevos y actualizar los
customBiddingAlgorithms
existentes - La capacidad de subir secuencias de comandos a través del proceso de recuperar una ubicación de recurso disponible y, luego, subir el archivo a esa ubicación
- Un nuevo servicio
customBiddingAlgorithms.scripts
para recuperar y crearcustomBiddingScripts
.
Se agregó una página nueva para implementar ofertas personalizadas a nuestra guía Cómo administrar líneas de pedido, en la que se describe el proceso de creación de un algoritmo de ofertas personalizadas, subir una secuencia de comandos y asignar ese algoritmo para que sea la estrategia de oferta de una línea de pedido.
Se agregó compatibilidad con la versión más reciente de SDF, v5.4, por medio de la incorporación de un valor enum SdfVersion
.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos customBiddingAlgorithms customBiddingAlgorithms.scripts media Se agregaron los siguientes valores enum:
Enum Valores SdfVersion
14 de septiembre de 2021
Se agregó compatibilidad con la orientación por proximidad en los tipos de segmentación TARGETING_TYPE_BUSINESS_CHAIN
y TARGETING_TYPE_POI
.
Se agregó la capacidad de buscar 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 campos sharedAdvertiserIds
y customBiddingAlgorithmState
nuevos 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 a la enumeración Exchange
.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Cuerpo de la solicitud deTargetingOptions.search Se agregaron los siguientes valores enum:
Enum Valores CustomBiddingAlgorithmType Intercambio TargetingType Los siguientes métodos de lista ahora se pueden filtrar con las siguientes propiedades:
Método Campos customBiddingAlgorithms.list
4 de agosto de 2021
Se agregó compatibilidad con la segmentación de inventario habilitada por 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 de varios métodos de listas de opciones de segmentación asignadas de anunciantes, campañas, pedidos de inserción y líneas de pedido.pageSize
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption TargetingOption Se agregaron los siguientes valores enum:
Enum Valores TargetingType Se aumentó el tamaño máximo de la página para los siguientes métodos de lista:
26 de mayo de 2021
Se inició 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 usa un anunciante durante un mes determinado
Se agregó el campo campaignBudgets
al recurso de la campaña. Los segmentos de presupuesto de pedidos de inserción se pueden vincular a un presupuesto de campaña, lo que restringe el presupuesto de suma de los segmentos asociados al importe total del presupuesto de la campaña.
Se agregó compatibilidad con la segmentación de 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 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 enum:
Enum Valores AssignedTargetingOption.Recency Exchange TargetingType Los siguientes valores de enumeración ahora son válidos para los siguientes campos:
Recurso Field 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 que usan el recurso para la segmentación. Se habilitaron las propiedades filter
nuevas para el método de lista de líneas de pedido, que permiten al usuario recuperar solo líneas de pedido que usen 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 con 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íneas 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ñas y un método adicional de lista masiva.
Se amplió la segmentación de apps para permitir la segmentación de apps a 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 del canal y de la lista de palabras clave negativas. Entre estos cambios, se incluyen los siguientes:
- Se agregaron métodos
replace
, que permiten al usuario reemplazar por completo el contenido existente de un canal o una lista de palabras clave negativas. - Se quitó el 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 lista de 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 la página para los siguientes métodos de lista:
Método Tamaño máx. de página anterior Nuevo tamaño máx. 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 enum 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 incorporaron 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 creativo y se agregaron campos de creatividades de solo salida para que los usen 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 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 enum:
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 la administración de pedidos de inserción de TV y líneas de pedido de transmisión libre mediante la introducción de un nuevo campo InserciónOrderType y un nuevo valor enum LineItemType. Se agregó compatibilidad con líneas de pedido de apps para dispositivos móviles mediante un campo de línea de pedido mobileApp
.
Se amplió la compatibilidad con exchange, google audience y SDF mediante valores de enumeración adicionales. Se introdujo la capacidad de filtrar y ordenar valores advertisers.list
por hora de última actualización.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos InsertionOrder LineItem Se agregaron los siguientes valores enum:
Enum Valores Exchange GoogleAudienceType LineItemType SdfVersion Los siguientes métodos de lista ahora pueden ordenarse y filtrarse 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 varios resultados de métodos de lista de recursos por su última actualización. Se agregó 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 enum:
Enum Valores Exchange LineItemWarningMessage Los siguientes métodos de lista ahora pueden ordenarse y filtrarse 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 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. Se agregaron campos de ID de segmentos personalizados a los objetos de DoubleVerify e Integral Ad Science utilizados en la segmentación de 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 enum:
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 tasa de clics (CTR). Se agregó warningMessages
como campo filtrable cuando se enumeran líneas de pedido.
Además de las funciones nuevas, ahora están vigentes nuevos límites de cuota y hay nueva documentación disponible para usar solicitudes por lotes.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos LineItem Se agregaron los siguientes valores enum:
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 campos nuevos filtrables a varios métodos de lista.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Cuerpo de la respuesta de anunciantes.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
Lanzamiento de 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 líneas de pedido de audio y el uso de algoritmos de ofertas personalizadas en líneas de pedido y estrategias de oferta de pedidos 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 enum:
Enum Valores BiddingStrategyPerformanceGoalType LineItemType Los siguientes métodos de lista ahora pueden ordenarse y filtrarse según los siguientes campos:
Método Campos advertisers.lineItems.list Se agregaron los siguientes permisos para utilizarlos 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 que agregó un método de creación para los canales de socios y anunciantes, campos nuevos 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 enum:
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 incorporó la capacidad de crear, aplicar parches y propagar un subconjunto de entidades segmentables, 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 creatividades insertionOrder.insertionOrderBudgetSegment
27 de abril de 2020
Se lanzó un gran conjunto de atributos que expandió 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