REST Resource: exchanges.inventorySources

Recurso: InventorySource

Es el modelo de ejecución de una fuente de inventario de DV360.

Representación JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Campos
name

string

Solo salida. Es el nombre del recurso relativo del pedido. El servidor lo genera. Ejemplo: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Solo salida. Es el estado del comprador.
sellerStatus

enum (SellerStatus)

Es el estado del vendedor.
transactionType

enum (TransactionType)

Solo salida. Es el tipo de transacción del producto.
pricingType

enum (PricingType)

Solo salida. Es el tipo de precio del producto.
rateDetails

object (RateDetails)

Solo salida. Detalles de la tarifa.
startTime

string (Timestamp format)

Solo salida. Fecha y hora en que se activa este producto. Debe ser anterior a endTime. La hora de inicio no puede ser más de 1 año en el futuro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. Fecha y hora en que este producto se vuelve inactivo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Intercambio que proporciona la previsión del volumen diario. Se usa para determinar el ritmo y habilitar la elección del comprador. Este campo ya no está disponible.
audienceMatchRate

number

Solo salida. Es el porcentaje de coincidencias de público previsto para los acuerdos de Programática garantizada con segmentación por público, que utiliza el exchange para determinar cuántas solicitudes adicionales se deben enviar. Es un número decimal entre 0 y 1, cuyo inverso se debe usar como multiplicador para las impresiones. El valor 0 indica que el campo no está configurado y, por lo tanto, no tiene segmentación por público. Ejemplo: “0.125”. Esto indica que el 12.5% de las solicitudes coincide con la segmentación por público y que la cantidad de solicitudes enviadas debe ser 8 veces la cantidad de impresiones negociadas.
makegoodRequested

boolean

Solo salida. Indica si el comprador solicitó una compensación.
makegoodRequestedReason

string

Solo salida. Es el motivo por el que el comprador solicita la compensación.
percentFrequencyCapExcludedTraffic

string (int64 format)

Es el porcentaje de tráfico excluido de la limitación de frecuencia para un acuerdo de Programática garantizada. Es un número entero entre 0 y 100. El valor 0 (también el valor predeterminado) indica que no hay exclusión y, por lo tanto, todo el tráfico es apto para el límite de frecuencia. El valor 100 indica exclusión completa y, por lo tanto, no se aplicará ningún límite de frecuencia. Los valores entre 0 y 100 generarán una exclusión parcial. Por ejemplo, un valor de 20 hará que el 20% del tráfico se excluya del límite de frecuencia.
dv360WseatId[]

string (int64 format)

Solo salida. Son los wseats que actualmente tienen permiso para acceder a la fuente de inventario.
lastModifiedTime

string (Timestamp format)

Solo salida. Es la última vez que se actualizó la fuente del inventario. Ten en cuenta que algunas actualizaciones internas de DV3 cambiarán la hora de la última modificación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

Opcional. Es la configuración para la aprobación de la creatividad. La aprobación puede ser obligatoria a nivel del exchange o del publicador.

BuyerStatus

Es el estado del comprador.

Enums
BUYER_STATUS_UNSPECIFIED No se especificó el estado del comprador. El valor de entrada no es válido.
BUYER_STATUS_ACTIVE El estado del comprador está activo. Se asignó una línea de pedido y una creatividad válida.
BUYER_STATUS_PENDING El estado del comprador está pendiente. Este estado significa que el acuerdo no está activo y que el comprador debe realizar ciertas acciones.
BUYER_STATUS_PAUSED Es el estado del comprador que se detuvo por el comprador.

SellerStatus

Es el estado del vendedor.

Enums
SELLER_STATUS_UNSPECIFIED No se especificó el estado del vendedor. Indica que se desconoce el estado de la negociación, lo que es inesperado. El valor de entrada no es válido.
SELLER_STATUS_ACTIVE El estado del vendedor es activo. La fuente de inventario está activa en el intercambio.
SELLER_STATUS_PAUSED Se pausó el estado del vendedor.

InventorySourceVolumeForecast

Es la previsión del volumen de solicitudes diarias para una fuente de inventario. Se aplican las siguientes reglas de validación: - Se debe proporcionar una entrada para cada día de la semana. - El volumen no debe ser negativo. - Se requiere el timeZoneId y debe ser válido.

Representación JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Campos
dailyVolumes[]

object (DailyVolume)

Es el pronóstico de volúmenes diarios.
timeZoneId

string

Zona horaria de la base de datos de zonas horarias de IANA, p.ej., "America/New_York", que se usa para los volúmenes diarios.

DailyVolume

Es el volumen de solicitudes de una fuente de inventario para un día determinado.

Representación JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Campos
day

enum (DayOfWeek)

Día de la semana al que se aplica el volumen de solicitudes.
volume

string (int64 format)

Es el volumen de solicitudes previsto para el día de la semana determinado.

DayOfWeek

Representa un día de la semana.

Enumeraciones
DAY_OF_WEEK_UNSPECIFIED No se especifica el día de la semana.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY Miércoles
THURSDAY Jueves
FRIDAY Viernes
SATURDAY Sábado
SUNDAY Domingo

CreativeApprovalConfig

Es la configuración para la aprobación de la creatividad.

Representación JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Campos
requiresExchangeApproval

boolean

Obligatorio. Indica si la creatividad requiere aprobación previa a la transferencia a nivel del intercambio.
publisherConfigs[]

object (PublisherConfig)

Opcional. Es la configuración del publicador.

PublisherConfig

Es la configuración del editor (publisher_config). Si se establece publisher_config, la creatividad requiere aprobación previa a la transferencia a nivel del publicador.

Representación JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Campos
publisherId

string

Obligatorio. Es el ID del publicador.
publisherDisplayName

string

Obligatorio. Es el nombre del publicador.

Métodos

get

 Obtiene una fuente de inventario.

list

 Enumera las fuentes de inventario.

patch

 Actualiza una fuente de inventario.