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 de recurso relativo del pedido. El servidor lo genera. Ejemplo: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Solo salida. Estado del comprador
sellerStatus

enum (SellerStatus)

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. Es la hora en la que este producto se activa. Debe ser anterior a endTime. La hora de inicio no puede ser superior a 1 año en el futuro.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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. Es la hora en la que este producto se vuelve inactivo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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)

El mercado proporcionó un pronóstico de volumen diario. Se usa para determinar el ritmo y permitir 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 el mercado utiliza para determinar cuántas solicitudes adicionales se deben enviar. Es un decimal entre 0 y 1, cuya inversa se debe usar como multiplicador para las impresiones. 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 la cantidad de solicitudes enviadas debe ser 8 veces las impresiones negociadas.
makegoodRequested

boolean

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

string

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

string (int64 format)

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 la limitación de frecuencia. El valor 100 indica una exclusión completa y, por lo tanto, no se aplicará ninguna limitación de frecuencia. Los valores entre 0 y 100 generarán una exclusión parcial. Por ejemplo, un valor de 20 hará que se excluya el 20% del tráfico de la limitación de frecuencia.
dv360WseatId[]

string (int64 format)

Solo salida. Los wseats que actualmente tienen permiso para 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 RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "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. La configuración para la aprobación de creatividades. Se puede solicitar aprobación a nivel del mercado o del publicador.

BuyerStatus

Estado del comprador

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

SellerStatus

Estado del vendedor

Enumeraciones
SELLER_STATUS_UNSPECIFIED El estado del vendedor no se especifica. Es inesperado y significa que se desconoce el estado de la negociación. El valor de entrada no es válido.
SELLER_STATUS_ACTIVE Estado del vendedor: activo La fuente de inventario está activa en el mercado.
SELLER_STATUS_PAUSED Estado del vendedor detenido.

InventorySourceVolumeForecast

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 debe ser no negativo. - El timeZoneId es obligatorio y debe ser válido.

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

object (DailyVolume)

Pronóstico de los volúmenes diarios.
timeZoneId

string

Es la 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

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

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

enum (DayOfWeek)

Es el 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

La configuración para la aprobación de creatividades.

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 mercado.
publisherConfigs[]

object (PublisherConfig)

Opcional. Es la configuración del publicador.

PublisherConfig

La configuración del publicador (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. El ID del publicador.
publisherDisplayName

string

Obligatorio. Es el nombre del editor.

Métodos

get

 Obtiene una fuente de inventario.

list

 Muestra las fuentes de inventario.

patch

 Actualiza una fuente de inventario.